Skip to content

No code, no charge. Every route is measured, and failing routes are removed.

How we measure

v1REST · JSON · 6 endpoints

SMS verification API: receive SMS codes over REST

The FastOTP API buys a one-time phone number for any of 8 services in 5 countries and returns the SMS verification code sent to it, through 6 endpoints, with a full refund whenever no code arrives.

Create an account to get a keyRead the quickstart
Example · POST /api/v1/orders
curl -X POST https://fastotp.io/api/v1/orders \
  -H "Authorization: Bearer $FASTOTP_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "service": "whatsapp",
    "country": "indonesia",
    "max_price": "0.13"
  }'

201Created · the order, with its number

{
  "id": "ord_9f2k1x",
  "status": "active",
  "service": "whatsapp",
  "country": "indonesia",
  "phone": "+6283150707440",
  "price": "0.13",
  "code": null,
  "created_at": "2026-10-12T08:55:30Z",
  "expires_at": "2026-10-12T09:15:30Z",
  "seconds_to_code": null
}
Base URL
https://fastotp.io/api/v1
Auth
Authorization: Bearer sk_live_…
Format
JSON, UTF-8
Money
USD as strings: "0.13"
Time
ISO 8601, UTC

How it behaves

Four rules the API is built on

Written for integrations and test suites that run unattended: each rule removes one way of losing money or state when something goes wrong.

  1. 1One catalogue, one price list

    The API reads the same routes and the same live prices as the website. There is no separate API tariff, and a route suspended on the site is refused over the API too.

  2. 2Charged only for delivered codes

    Your balance is charged when an order is created and returned in full if the order fails, expires or is cancelled. Only an order that delivered a code keeps its charge.

  3. 3Named errors

    Every failure comes back as one of 14 codes, such as price_changed or no_numbers. The docs say for each one whether anything was charged and what to do next.

  4. 4Safe retries

    Send an Idempotency-Key when you create an order. A retry after a timeout then returns the original order, for 24 hours, instead of buying a second number.

Request and response

What comes back when it works, and when it does not

Poll the order every 3 to 5 seconds until its status is completed. If a request cannot be served, the response says why in a field you can branch on, and nothing is charged.

The code has arrived

ShellRequest
curl https://fastotp.io/api/v1/orders/ord_9f2k1x \
  -H "Authorization: Bearer $FASTOTP_KEY"
JSONExample response · 200 OK
{
  "id": "ord_9f2k1x",
  "status": "completed",
  "service": "whatsapp",
  "country": "indonesia",
  "phone": "+6283150707440",
  "price": "0.13",
  "code": "482913",
  "created_at": "2026-10-12T08:55:30Z",
  "expires_at": "2026-10-12T09:15:30Z",
  "seconds_to_code": 11
}

The price rose above your limit

JSONExample response · 409 Conflict
{
  "error": {
    "code": "price_changed",
    "message": "The price for this route has changed.",
    "price": "0.16"
  }
}

The order was not created and your balance is untouched. Every other error has the same shape; all 14 are listed in the API error reference.

Reference

All 6 endpoints

Paths are relative to https://fastotp.io/api/v1. A key carries scopes, and each endpoint names the one it needs.

Endpoints of the FastOTP API, version 1
EndpointWhat it doesScope
GET/routesList routes with their live price, sale status and measured delivery rate.catalog:read
GET/accountRead your balance.any valid key
POST/ordersBuy a number. Charges your balance and returns the order.orders:create
GET/orders/{id}Read one order. Poll it until the code arrives.orders:read
GET/ordersList your orders, newest first, optionally filtered by status.orders:read
DELETE/orders/{id}Cancel an order that has no code yet and refund it.orders:cancel

Limits per key: 30 order creations and 120 status polls per minute. See rate limits and safe retries.

Documentation

Four guides, each about one thing

Pricing per routeAPI orders cost exactly what the website charges, from $0.05 per code. No subscription and no API fee.View pricing

Create an account to get an API key

Keys are made in the account area. Each one carries the scopes you choose, is shown once, and can be revoked at any time.

Create accountQuickstart guide
  1. 1Create an accountNo subscription and no monthly fee.
  2. 2Add balanceOrders are paid from it, one code at a time.
  3. 3Create a keyChoose its scopes. The key is shown once and stored only as a hash.