Customer API

Use this API to discover available services, rent numbers, receive SMS codes, and view account data.

Overview

Base URL: https://smsverify.online

Endpoints that access your account require your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY
Accept: application/json

This page documents customer-facing endpoints only. Administrative operations, internal worker callbacks, and payment callbacks are intentionally not documented or exposed here.

Catalog

GET /api/countries?service=telegram

List supported countries. The optional service or project parameter filters results by project.

GET /api/projects?country=US

List projects, optionally limited to a country.

GET /api/services?country=US

List available services and their current global prices.

Numbers and SMS

GET /api/get_number?country=US&project=telegram

Request a number. Optional wait_seconds waits for assignment, and number requests a specific supported number.

{
  "order_id": 12345,
  "phone": "+15551234567",
  "country": "US",
  "project": "telegram",
  "status": "assigned"
}

GET /api/get_sms?order_id=12345

Poll for the SMS code. A pending order returns waiting or assigned; a completed order includes sms_code.

POST /api/release_number

Release an active number you no longer need.

{
  "order_id": 12345
}

Account and orders

GET /api/balance

Return total, reserved, and available balances.

GET /api/orders?page=1&size=20

List your orders. size is from 1 to 100; optionally filter with status.

GET /api/order/12345

Return one of your orders.

Errors

Status	Meaning
`200`	Request completed.
`400`	Invalid parameters, unsupported country/project, or an order cannot transition.
`401`	Your API key is missing, invalid, or inactive.
`404`	The requested order does not exist in your account.
`429`	Too many requests. Retry with backoff.
`503`	No number is currently available. Retry later or choose another country/project.