Reseller API

Route requests to InstantSMS servers A–E individually. Discover each server's countries and services, and check your wallet balance.

Authentication

Send your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Create keys from your dashboard under Reseller API. Each key can be scoped to a single server or all.

Servers

Server A — TextVerified · US only
Server B — 5sim · Global
Server C — SMSBower · Global
Server D — SmsPool · Global
Server E — HeroSMS · Global

Endpoints

List available servers

GET https://instantsocialsms.com/api/public/reseller/servers

Wallet balance

GET https://instantsocialsms.com/api/public/reseller/balance

Countries for a server

GET https://instantsocialsms.com/api/public/reseller/servers/{a|b|c|d|e}/countries

Server A always returns us. Other servers return their provider country lists.

Services (with prices) for a server

GET https://instantsocialsms.com/api/public/reseller/servers/{a|b|c|d|e}/services?country={code}

country is required for C and E; optional for B (defaults to usa); ignored for A and D. Prices are in NGN. Server A and D return null prices — price is quoted at purchase time.

Example

curl -H "Authorization: Bearer YOUR_KEY" \
  https://instantsocialsms.com/api/public/reseller/servers/b/services?country=usa

Errors

{
  "error": "invalid_api_key",
  "message": "invalid_api_key"
}

Common codes: missing_authorization_header, invalid_api_key, api_key_disabled, scope_forbidden, invalid_server, upstream_error.