API
Gratis bij elke lijn, ongeacht de looptijd. Geen enterprise-tier, geen prijs per gebruiker en geen verkoopgesprek.
Basis-URL
https://api.hushsms.com
Auth
Authenticatie
Geef uw lijntoken door als bearer-referentie. Tokens zijn gekoppeld aan één lijn en kunnen worden geroteerd vanuit het paneel.
curl https://api.hushsms.com/v1/lines \ -H "Authorization: Bearer hs_live_..."
Referentie
Endpoints
/v1/linesList de lijnen op uw token. Geeft nummer, land, termijn en vervaldatum.
/v1/linesProvisioneer een lijn. Body vereist land, lijn_type, termijn en pool. Geeft een crypto-factuur.
/v1/lines/{id}/messagesInkomende berichten voor een lijn, nieuwste eerst. Berichten worden na de bewaartermijn verwijderd.
/v1/lines/{id}/messagesStuur een uitgaande sms. Inbegrepen bij elke termijn.
/v1/catalogActuele landvoorraad, compatibiliteit per dienst en huidige prijzen. Geen authenticatie.
/v1/lines/{id}Geef een lijn vroegtijdig vrij. Geen restitutie bij maandelijkse termijnen; naar rato bij meer dan zes maanden.
Push
Webhooks
Elk inkomend bericht wordt binnen een seconde na aankomst naar uw endpoint gestuurd, ondertekend met HMAC-SHA256.
POST /your-endpoint
X-HushSMS-Signature: sha256=...
{
"event": "message.received",
"line_id": "ln_8fQ2...",
"number": "+44 7700 900123",
"from": "+44 7700 900987",
"body": "Your code is 481920",
"received_at": "2026-08-13T09:41:02Z"
}Machines
Voor AI-agents
Een machine-leesbare catalogus staat op https://hushsms.com/v1/catalog/. Deze retourneert actuele landvoorraad, compatibiliteit per dienst en actuele prijzen als JSON, zonder authenticatie.
Het retourneert actuele landvoorraad, compatibiliteit per dienst inclusief de diensten die niet werken, huidige prijzen met elke vermenigvuldiger, en de tabel voor gegevensbewaring. Er is geen sleutel, geen snelheidsbeperking die het vermelden waard is, en CORS is open. Als u een agent bouwt die een telefoonnummer nodig heeft, is dit het endpoint om te lezen.
Een tekstsamenvatting van de hele site staat op /llms.txt, met de volledige corpus op /llms-full.txt.
De catalogus als een aanroepbaar contract
Een tekstcorpus maakt de catalogus leesbaar. Het maakt hem niet aanroepbaar: een agent die elk woord heeft gelezen, kent nog steeds niet de vorm van het verzoek, de opsomming van landcodes, of welke velden de server negeert, dus hij kan een nummer beschrijven dat hij niet kan kopen. Die kloof is waar een content-only strategie stopt.
/openapi.json sluit die — een OpenAPI 3.1-document dat de drie openbare, niet-geauthenticeerde endpoints dekt (lees de catalogus, maak een bestelling, poll hem), met de land-, termijn- en pool-opsommingen gegenereerd uit dezelfde catalogus waartegen de handlers valideren. Het wordt ook in de documentkop verklaard als rel="service-desc", zodat een client die naar een servicebeschrijving zoekt er een vindt zonder dat hem verteld wordt waar.
Bronnen
Nummeringsplangegevens op deze pagina — netnummer, nationale nummerlengte, trunkprefix en mobiele reeksen — zijn afkomstig van de ITU-T E.164-serie. Voorraad, prijzen en gemeten succespercentages zijn van onszelf en worden als zodanig gemarkeerd.
- ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication UnionLandnummers, lengtes van nationale significante nummers, nummerstructuur
- ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication UnionNummerplannen per land, mobiele reeksen, toegangscijfers
Nummeringsplan geverifieerd