All requests except /api/login, /api/register и /api/public/*, require a Bearer token.
Authorization: Bearer <api_token>
Base URL: https://sms-numbers.co/api
HTTP/HTTPS API
Connect numbers, send and receive SMS from your app. Bearer token auth, JSON responses, public endpoints without a key.
Quick start
3
Authorization
Send the token in the
Authorization.4
Methods
Use the endpoints below for numbers and SMS.
5
Balance
Top up your balance to buy a number or send SMS.
Authentication
Numbers API
GET
List numbers
Returns the numbers on your account.
GET https://sms-numbers.co/api/numbers
Header: Authorization: Bearer <api_token>
filter (string) — optional status filter, e.g. active.
GET
Number details
Returns details for a specific number.
GET https://sms-numbers.co/api/number/{id}
Path: id (integer) — number ID from the list.
GET
Search numbers to connect
Available numbers by country.
GET https://sms-numbers.co/api/numbers/search/{iso}
iso (string) — country code, e.g. ru, us.
Rates: GET https://sms-numbers.co/api/public/countries и GET https://sms-numbers.co/api/public/prices/{country_id}.
POST
Connect a number
Connects the selected number.
POST https://sms-numbers.co/api/number/buy
Body: id (integer) — number ID from search results. Headers: Bearer token and Content-Type: application/json.
POST
Disconnect a number
Disconnects the selected number.
POST https://sms-numbers.co/api/number/cancel
Body: id (integer) — number ID from the list.
POST
Update number settings
Incoming SMS forwarding and a custom tag.
POST https://sms-numbers.co/api/number/update
Body: id (required), email, number, user_tag (optional).
Messages API
GET
List messages
GET https://sms-numbers.co/api/messages
GET
Conversations
Messages grouped into conversations.
GET https://sms-numbers.co/api/app/messages
GET
Messages by number
GET https://sms-numbers.co/api/app/messages/{number}
POST
Send SMS
POST https://sms-numbers.co/api/message/send
Body: from, to, body.
Account and payments
GET
Profile
GET https://sms-numbers.co/api/account/profile
GET
Balance
GET https://sms-numbers.co/api/account/balance
GET
Payment history
GET https://sms-numbers.co/api/payments
POST
Create a payment
POST https://sms-numbers.co/api/payment/create
Public endpoints
No authentication required.
GET
List countries
GET https://sms-numbers.co/api/public/countries
GET
Countries with numbers
GET https://sms-numbers.co/api/public/countries/numbers
GET
List services
GET https://sms-numbers.co/api/public/services
POST
Login
POST https://sms-numbers.co/api/login
Body: email, password.
POST
Sign up
POST https://sms-numbers.co/api/register
Server responses
200 OKSuccess400 Bad RequestInvalid request parameters401 UnauthorizedMissing or invalid token402 Request FailedValid parameters, but the request failed403 ForbiddenForbidden404 Not FoundResource not found429 Too Many RequestsRate limit exceeded500 / 502 / 503 / 504Server-side errorSuccess: {"success": true, "data": {...}, "message": "..."}
Error: {"success": false, "message": "...", "data": {...}}
Sign Up
Register now, verify your email, and get test funds to try out phone numbers
