SMS Arena API
API documentation
Programmatic access to the same capabilities as the dashboard: service rental, full number rental, incoming SMS, balance, and extensions.
https://api.sms-arena.com/v1API access
Loading keys…
Authentication
All /v1 methods require a key. Use the X-API-Key header.
| Method | Format |
|---|---|
| API key | X-API-Key: sa_live_… |
| Bearer | Authorization: Bearer sa_live_… |
curl -H "X-API-Key: sa_live_…" https://api.sms-arena.com/v1/Balance
Balance
GET/v1/Balance
Returns the dashboard wallet balance in USD.
{
"balance": 12.5,
"accountBalanceInUSD": 12.5,
"currency": "USD",
"user_id": 42
}Catalog
Countries and prices match what the website shows.
GET/v1/Countries?rentalType=service|full
Country list for rentalType=service or full.
GET/v1/ProductPrices?country=DE&rentalType=service
Service rental prices (page/limit pagination).
GET/v1/ProductPrices?country=DE&rentalType=full
Full number rental durations for a country.
GET/v1/products/{service_id}/options?country=DE
Duration and price options for one service in a country.
Orders and bookings
Creating a rental debits the wallet. 402 — insufficient balance, 503 — out of stock.
POST/v1/Orders
Service rental:
{
"rentalType": "service",
"country": "DE",
"service_id": 123,
"days": 7
}Full number rental:
{
"rentalType": "full",
"country": "DE",
"days": 30
}GET/v1/Orders
Recent account orders.
GET/v1/OrderBookings
List rentals. Optional ?status=active.
GET/v1/OrderBookings/{id}
Single rental by ID.
Incoming SMS
GET/v1/Sms
Latest SMS for the account (up to 100).
GET/v1/Sms/{booking_id}
SMS for a specific rental. Poll while waiting for a code.
Extend
GET/v1/OrderBookings/{id}/ExtendOptions
Available renewal terms and prices (same rules as the dashboard).
POST/v1/OrderBookings/{id}/Extend
Extend an active rental. Debits the wallet.
{ "days": 7 }Notes
Balance is the cabinet USD wallet. Timed service rental and full number rental are supported.