API

बेस पता

https://today-sms.com/api/v1

प्रमाणीकरण

हेडर Authorization: Bearer YOUR_API_KEY। पहले टॉप-अप के बाद API कुंजी पेज पर कुंजी बनाएं। हर मिनट 300 अनुरोध तक।

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

GET /balance

USD में आपका बैलेंस।

उदाहरण जवाब

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

GET /apps

अभी नंबर वाले ऐप: कोड, नाम, सबसे कम कीमत, देश।

उदाहरण जवाब

[
  { "app": "telegram", "name": "Telegram", "from": "0.4515", "countries": 61 }
]

GET /prices?app=telegram

एक ऐप के लिए देश, सबसे सस्ता पहले: देश कोड, ISO कोड, कीमत, उपलब्ध नंबर।

उदाहरण जवाब

[
  { "country": "indonesia", "iso": "id", "price": "0.4515", "stock": 702866 }
]

POST /numbers {"app":"telegram","country":"indonesia"}

नंबर खरीदता है। कीमत आपके बैलेंस से कटती है।

उदाहरण जवाब

{
  "id": 1042,
  "phone": "+6281234567890",
  "price": "0.4515",
  "status": "waiting",
  "expires_at": "2026-10-14T09:20:00Z"
}

GET /numbers/{id}

स्थिति और अब तक आए सभी SMS।

उदाहरण जवाब

{
  "id": 1042,
  "status": "received",
  "sms": [ { "code": "482913", "text": "Your code is 482913", "at": "2026-10-14T09:02:11Z" } ]
}

POST /numbers/{id}/cancel

बिना SMS वाले नंबर को खरीदने के 120 सेकंड बाद रद्द करता है। पूरा रिफ़ंड।

उदाहरण जवाब

{
  "id": 1042,
  "status": "canceled",
  "refunded": "0.4515"
}

POST /numbers/{id}/finish

कोड मिलने के बाद नंबर बंद करता है।

उदाहरण जवाब

{
  "id": 1042,
  "status": "finished"
}

स्थितियां

त्रुटियां

त्रुटि होने पर 2xx के अलावा कोई स्टेटस और त्रुटि कोड वाला JSON लौटता है।

{
  "error": "not_enough_balance"
}