Get a number. Read the SMS.

You buy a number. Something texts it. The body lands on the order. Walk this once in the dashboard, then do it over HTTP.

What you need

An account, a Bearer key from the dashboard, and enough USD or credits to cover one number. Catalog ids are only global and premium. Copy country, service, and carrier strings exactly.

Programming bar: HTTP + JSON. You will poll. There is no list-orders endpoint. Store the id.

Walk it in the dashboard first

Developers who skip this step email us. We still like you. We like you more after one hand order.

  1. 01

    Create an account

    No paperwork. The shop is open as soon as you sign up.

  2. 02

    Add funds

    Deposit USD or buy a credit package. Every number is paid from that balance.

  3. 03

    Pick Global or Premium

    Global covers many countries. Premium is US numbers. Yes, only two.

  4. 04

    Order a number

    Google, WhatsApp, Telegram, and 900+ others. Confirm the price, then buy.

  5. 05

    Read the SMS on the order

    The number and the inbound message share one screen. Refreshing will not make it faster.

  6. 06

    No SMS? You are refunded

    Failed deliveries return credits or USD. You do not file a ticket for that.

Do it over HTTP

The same loop over HTTP

Every request: Authorization: Bearer SHS_your_api_key. Poll every 3–5 seconds until code or message is set.

Group Method Path Purpose
Account GET /me Balance and credits
Catalog GET /providers global or premium
Catalog GET /providers/{p}/countries Countries in that catalog
Catalog GET /providers/{p}/countries/{c}/services Services in a country
Catalog GET .../services/{s}/pricing Carriers and prices

Catalog, then buy, then poll.

GET https://seamtel.com/api/v1/providers
GET https://seamtel.com/api/v1/providers/global/countries
POST https://seamtel.com/api/v1/orders
GET https://seamtel.com/api/v1/orders/{id}

Then buy and poll

Orders

400 is funds or stock. 401 is a bad key. 429 means back off. Credits pay first; cost: 0 means credits covered it.

Group Method Path Purpose
Orders POST /orders Buy a number. Store the id.
Orders GET /orders/{id} Poll until code or message
Orders POST /orders/{id}/finish Mark the number used
Orders POST /orders/{id}/cancel Cancel before SMS arrives

Read the field-by-field schema

Or try a request in the API Reference.