HTTP/HTTPS API

All requests except /api/login, /api/register, /api/restore_password and /api/public/* require a Bearer token. The same methods are also available under /api/v1/....

Base URL: https://sms-numbers.co/api

For POST with a body send Content-Type: application/json. Responses return Content-Type: application/json; charset=UTF-8.

Returns numbers on your account (with country and status). Disposable numbers are hidden by default.

Header: Authorization: Bearer <api_token>

• filter (string) — optional status filter by filter_slug, e.g. active.
• include_disposable (boolean) — include temporary/OTP numbers.

Returns details for a specific number that belongs to you.

Path: id (integer) — number ID from the list. 404 if missing.

Kept for compatibility. Prefer public price endpoints to get tariffs, then buy with POST /api/number/buy.

Path: iso — country ISO code, e.g. ru, us.

Tariffs: GET https://sms-numbers.co/api/public/countries and GET https://sms-numbers.co/api/public/prices/{country_id}.

Places an order for a long-term number. Charges the balance; if funds are insufficient returns 402 with payment links. Profile email must be valid (used for SMS forwarding).

JSON body:

• agree_terms (required) — must be accepted (true / 1).
• number_price_id (integer) — tariff ID from /api/public/prices/{id} (required unless country is set).
• country (integer) — same as tariff ID (alias of number_price_id).
• period (integer, 1–36, default 1) — months of subscription.
• payment_method (optional, default balance) — use balance; other values create a pending payment.

Example body:

Cancels an unconnected order (with refund if paid from balance) or schedules disconnection of an active number.

• id (required, integer) — number ID.
• asap (boolean, optional) — disconnect immediately; otherwise scheduled until valid_till.

Incoming SMS forwarding and a custom tag.

• id (required).
• email — forward incoming SMS to email (dest_email).
• number — forward to another phone (dest_number).
• user_tag — custom label.

Orders a disposable number for a service (≈15 minutes). Same balance / payment-link behaviour as long-term buy.

• service_id (required) — service ID from /api/public/services.
• country_id (required) — country ID from /api/public/services/{id}/countries.
• agree_terms (required) — must be accepted.
• payment_method (optional, default balance).

Flow: GET /api/public/services → GET /api/public/services/{id}/countries → POST /api/service/buy.

Countries that currently have eSIM packages. Optional query q filters by name or ISO code.

Data plans for a country. iso is a two-letter code, for example de. Each package includes package_id, data volume, validity_days and price_eur.

Charges the account balance and returns the order with QR and installation fields. If the balance is too low, the response is 402 with payment links.

package_id (required) — package id from the packages list.

Completed eSIM orders, newest first. Query page for the next page (20 per page).

One order: sims with qrcode, qrcode_url, iccid and direct_apple_installation_url when Airalo provides them, plus installation HTML.

All SMS for the account.

Latest message per conversation partner (chat list).

Full history with {number}. Marks those messages as viewed.

Sends one or more outbound SMS. Requires positive balance.

• from (string) — your virtual number; if omitted/unknown, the system sender is used.
• to (required) — destination; digits and + ( ) -; several numbers separated by commas.
• body (required) — message text.

Current user object.

Optional fields: firstname, lastname, phone, country, city, address, zip, company, telegram_id.

Returns credit and currency code.

Payments for the account, newest first.

Creates a pending top-up and returns a payment link.

• amount (required, > 0) — amount in EUR.
• method (required) — card or crypto.
• number_price_id (optional) — attach a number tariff description.

Response includes payment_link → /api/payment/{id}/{method}/pay.

All countries in the catalog.

Countries that have long-term number tariffs.

Country info, operators (MCC/MNC) and available product types.

Long-term tariffs (numbers_prices), disposable (numbers_disposable_prices), outbound SMS rates (messages_outgoing_prices), and country meta.

OTP / registration services available via API.

Countries and setup prices for a service (id from the services list).

Body: email, password. Returns data.token.

Body: email, password (min 6); optional firstname, lastname. Returns user with API token.

Body: email — sends a reset link.

Success: {"success": true, "data": {...}, "message": "..."}

Error: {"success": false, "message": "...", "data": {...}}