API ডকস

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

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

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

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

$ curl https://today-sms.com/api/v1/prices?app=telegram \
  -H "Authorization: Bearer YOUR_API_KEY"

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

$ 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",
  "app": "telegram",
  "country": "indonesia",
  "phone": "+6281234567890",
  "price": "0.4515",
  "refunded": "0.0000",
  "status": "waiting",
  "expires_at": "2026-10-18T09:20:00.000Z",
  "sms": []
}

$ 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/numbers/N-7K2M-QX4P-9D3A/cancel \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "canceled",
  "refunded": "0.4515"
}

$ curl -X POST https://today-sms.com/api/v1/numbers/N-7K2M-QX4P-9D3A/finish \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "N-7K2M-QX4P-9D3A",
  "status": "finished"
}

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

[
  { "iso": "us", "dial": "1", "price": "0.0042" },
  { "iso": "gb", "dial": "44", "price": "0.0066" }
]

$ 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"

{
  "id": "m_7Q2K9X",
  "status": "done",
  "cost": "0.0136",
  "refunded": "0.0083",
  "reports": [
    { "to": "+14155550100", "status": "delivered", "at": "2026-10-18T10:00:04Z" },
    { "to": "+447700900123", "status": "failed", "at": "2026-10-18T10:00:09Z" }
  ]
}

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

{
  "id": "m_7Q2K9X",
  "status": "canceled",
  "refunded": "0.0136"
}