API de location de numéro de téléphone

Louez des numéros, lisez les SMS entrants, prolongez et annulez depuis votre propre code. JSON sur HTTPS avec une clé API de la console.

URL de base: https://snsnumber.com/api/v1
Authentification: Authorization: Bearer snk_...
Limite de débit: 300 requêtes par minute par clé

Créez la clé dans la console sous API. Les prix sont en dollars américains sous forme de chaînes avec deux décimales. Les heures sont au format ISO 8601 en UTC.

Points de terminaison

GET/balanceVotre crédit en dollars américains.

{ "balance": "120.00", "currency": "USD" }

GET/prices?country=usPays, périodes et prix. Laissez vide le pays pour tous.

{ "currency": "USD", "countries": [ { "country": "us", "name": "United States", "dial": "+1",
  "periods": [ { "days": 15, "price": "36.00" }, { "days": 30, "price": "54.00" } ] } ] }

POST/rentalsLouez un numéro. Corps : pays et jours.

curl -X POST https://snsnumber.com/api/v1/rentals -H "Authorization: Bearer snk_..." \
  -H "Content-Type: application/json" -d '{"country":"us","days":30}'

{ "rental": { "id": "RN-7KQ2M9XWD4", "country": "us", "phone": "+14155550123", "state": "active",
  "days": 30, "ends_at": "2026-12-03T10:00:00.000Z", "can_cancel": true, "messages": [] } }

GET/rentals?state=activeVos locations, les plus récentes en premier (état : actif, expiré, annulé).

{ "rentals": [ { "id": "RN-7KQ2M9XWD4", "phone": "+14155550123", "state": "active", "message_count": 2 } ] }

GET/rentals/{id}Une location avec sa boîte de réception.

{ "rental": { "id": "RN-7KQ2M9XWD4", "messages": [ { "id": 18, "sender": "Verify",
  "text": "Your verification code is 482913.", "code": "482913", "received_at": "2026-11-03T10:01:12.000Z" } ] } }

POST/rentals/{id}/extendAjouter une période à une location active. Corps : jours.

{"days":15}  ->  { "rental": { "id": "RN-7KQ2M9XWD4", "extensions": 1, "ends_at": "2026-12-18T10:00:00.000Z" } }

POST/rentals/{id}/cancelRemboursement intégral dans les 20 minutes si aucun SMS n'est arrivé.

{ "rental": { "id": "RN-7KQ2M9XWD4", "state": "canceled" } }

Erreurs

Les erreurs renvoient un statut HTTP et un { "error": { "code", "message" } }.

Statut	Code	Signification
401	no_key, bad_key	Clé API manquante ou incorrecte
402	no_balance	Crédit insuffisant
404	not_found	Location introuvable
409	ended, cancel_denied	Location terminée ou délai d'annulation dépassé
429	rate_limited, too_many_active	300 requêtes par minute, ou 20 numéros actifs
503	network_error	Réessayez dans un instant