Developer API

Automate phone verification with simple GET requests. Pass your API key in the URL — just like you're used to.

Base URLhttps://YOUR_DOMAIN/api/v1
Auth?key=YOUR_API_KEY (or header Authorization: Bearer KEY)

Generate your key in the dashboard → API section.

Note: the API currently supports temporary numbers only — rent-number API coming soon.

Endpoints

GET/api/v1/balance?key=KEY

Your wallet balance

GET/api/v1/countries?key=KEY

List available countries

GET/api/v1/apps?key=KEY&country=USA

Apps for a country with your prices

GET/api/v1/number?key=KEY&country=USA&app=WhatsApp

Buy a number (reserves funds)

GET/api/v1/sms?key=KEY&id=ORDER_ID

Poll for the SMS code / status

GET/api/v1/cancel?key=KEY&id=ORDER_ID

Cancel & refund if no code yet

Quick start

  1. 1 · Check your balance

    curl "https://YOUR_DOMAIN/api/v1/balance?key=YOUR_API_KEY"

  2. 2 · Buy a number

    curl "https://YOUR_DOMAIN/api/v1/number?key=YOUR_API_KEY&country=USA&app=WhatsApp"

    Returns data.id (your order id) and data.number.

  3. 3 · Poll for the code

    curl "https://YOUR_DOMAIN/api/v1/sms?key=YOUR_API_KEY&id=ORDER_ID"

    status.code = 1000 with data.sms when the code arrives; 2000 while waiting.

  4. 4 · Cancel if needed

    curl "https://YOUR_DOMAIN/api/v1/cancel?key=YOUR_API_KEY&id=ORDER_ID"

Response format

{
  "status": { "code": "1000", "message": "Success" },
  "data": { "id": 123, "number": "12096496116", "app": "WhatsApp",
            "country": "USA", "status": "waiting_for_sms", "sms": null, "price": 0.38 }
}

Codes: 1000 = success, 2000 = error/waiting. Rate limit: 120 requests/min per key.

Get your API key