JSON · HTTPS · Clé Bearer

Recevez des codes de vérification et envoyez des SMS avec une seule API SMS

L'API TODAY SMS est une API pour développeurs qui réunit une API de vérification SMS pour recevoir des codes sur des numéros à usage unique et une API d'envoi de SMS vers 227 pays, avec une seule clé API et un seul solde. Toutes les requêtes et réponses sont en JSON, et les prix et règles de remboursement sont les mêmes que sur le site.

Voir la documentation API Créer un compte et obtenir une clé

today-sms.com/api/v1

$ curl -X POST https://today-sms.com/api/v1/numbers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"app":"telegram","country":"indonesia"}'
{
  "id": "N-7K2M-QX4P-9D3A",
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z"
}

$ curl https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "received",
  "sms": [
    { "code": "482913", "text": "Your code is 482913", "at": "2026-10-18T09:02:11.000Z" }
  ]
}

$ curl -X POST https://today-sms.com/api/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":["+14155550100","+447700900123"],"text":"Your code is 482913"}'
{
  "id": "m_7Q2K9X",
  "status": "queued",
  "recipients": 2,
  "parts": 1,
  "encoding": "GSM-7",
  "cost": "0.0136"
}

$ curl https://today-sms.com/api/v1/messages/m_7Q2K9X \
  -H "Authorization: Bearer YOUR_API_KEY"

300 requêtes par minute
Une seule clé pour recevoir et envoyer
Échecs et non-réceptions remboursés sur le solde
Rechargez avec 12 méthodes crypto

Ce que vous pouvez faire avec l'API SMS

API de vérification SMS

Choisissez une application et un pays, achetez un numéro et interrogez son statut pour obtenir le code de vérification. Si aucun SMS n'arrive, le montant total revient sur votre solde à la fin du délai.

API d'envoi de SMS

Envoyez votre message à jusqu'à 1 000 destinataires à la fois et recevez un rapport de livraison pour chacun. Ajoutez une heure programmée pour l'envoyer à ce moment-là.

API des prix et du stock

Obtenez via l'API les pays et prix par application, le nombre de numéros et le prix par SMS de chaque pays, et affichez-les tels quels dans votre propre service.

Un seul solde

La réception et l'envoi utilisent le même solde. Rechargez-le en USDT et consultez-le à tout moment via l'API.

Les méthodes en un coup d'oeil

Documentation complète

Méthode	Fonction
GET/balance	Consulter le solde
GET/apps	Lister les applications
GET/prices?app=telegram	Pays et prix d'une application
POST/numbers	Acheter un numéro
GET/numbers/{id}	Statut du numéro et SMS
POST/numbers/{id}/cancel	Annuler un numéro
POST/numbers/{id}/finish	Terminer un numéro
GET/messages/prices	Prix des SMS par pays
POST/messages	Envoyer des SMS
GET/messages/{id}	Statut d'envoi et rapports de livraison
POST/messages/{id}/cancel	Annuler un envoi programmé

Qu'est-ce qu'une API SMS ?

Une API SMS est une connexion qui permet à votre logiciel de recevoir ou d'envoyer des SMS par des requêtes HTTP. Le code fait ce qu'une personne cliquerait sur un écran web : les tâches répétitives comme les tests d'inscription automatisés, l'envoi de codes de vérification et les alertes de commande tournent sans aucune intervention.

L'API TODAY SMS offre deux choses à la fois. D'une part, une API de vérification SMS (API d'activation SMS) pour recevoir les codes de vérification des applications sur des numéros à usage unique, et d'autre part, une API d'envoi de SMS vers les téléphones mobiles du monde entier. Les deux utilisent la même URL, la même clé API et le même solde : pas d'inscription ni de recharge séparée.

Comment utiliser l'API de vérification SMS ?

Cela se fait en quatre étapes. Choisissez un code d'application avec GET /apps et consultez pays et prix avec GET /prices?app=CODE. Achetez un numéro avec POST /numbers pour obtenir le numéro et son id, puis appelez GET /numbers/{id} toutes les quelques secondes pour voir si le code est arrivé. Une fois le code reçu, fermez le numéro avec POST /numbers/{id}/finish.

Chaque numéro attend les SMS pendant 20 minutes, et les SMS reçus sur ce numéro pendant ce temps ne coûtent rien de plus. Si aucun SMS n'arrive, le montant total revient sur votre solde à la fin du délai, et si rien n'est arrivé, vous pouvez annuler vous-même avec POST /numbers/{id}/cancel à partir de 120 secondes après l'achat. Pour automatiser la vérification d'applications ou utiliser une API de numéros virtuels en volume, répétez simplement ce parcours.

Comment utiliser l'API d'envoi de SMS ?

Envoyez une liste de destinataires (to) et le texte du message (text) à POST /messages, et vous recevez l'id du message, le nombre de destinataires, le nombre de parties et le coût total. Saisissez les destinataires au format international avec + et l'indicatif, jusqu'à 1 000 par requête. Pour programmer, indiquez une heure UTC dans at.

Après l'envoi, consultez le rapport de livraison de chaque destinataire avec GET /messages/{id}. Il existe quatre statuts : pending, sent, delivered et failed, et le montant des parties en failed est ajouté à refunded et rendu sur votre solde. Annulez un envoi programmé pas encore parti avec POST /messages/{id}/cancel.

Utilisez la même méthode pour envoyer des codes de vérification (OTP). Chaque code compte pour un SMS, sans frais de vérification séparés, et vous pouvez obtenir le prix par SMS de chaque pays avec GET /messages/prices pour calculer vos coûts.

Que regarder dans une API SMS abordable ?

Regardez le total que vous payez réellement, pas seulement le prix par SMS de la grille. TODAY SMS n'a pas d'abonnement mensuel et ne débite que les parties envoyées, et les parties en échec ainsi que les codes de vérification jamais arrivés sont remboursés sur votre solde.

Ensuite, consultez la gestion des clés et les limites. Vous obtenez une clé API par compte et pouvez en créer une nouvelle à tout moment, ce qui bloque immédiatement l'ancienne. Les requêtes sont limitées à 300 par minute, suffisant pour la plupart des automatisations. Enfin, examinez le paiement. Vous pouvez recharger avec 12 méthodes crypto dont USDT, USDC et BTC sans carte, pour commencer immédiatement depuis n'importe quel pays.

Comment obtenir une clé API ?

Créez un compte, et dès que votre première recharge est créditée, vous pouvez créer une clé sur la page Clé API. La clé n'est affichée qu'une seule fois à sa création, alors conservez-la en lieu sûr. Envoyez-la avec chaque requête dans l'en-tête Authorization: Bearer.

Si vous pensez que votre clé a fuité, créez une nouvelle clé sur la page Clé API. L'ancienne cesse aussitôt de fonctionner. Toute personne disposant de votre clé peut acheter des numéros ou envoyer des SMS avec votre solde : ne la placez donc jamais dans du code navigateur ni dans un dépôt public.

Connectez l'API SMS dès aujourd'hui

L'inscription ne demande qu'un jeton. Dès que votre première recharge est créditée, créez une clé API, collez un exemple de la documentation et envoyez votre première requête.