Skip to content

Developers

SMS verification API

Private paid activations over HTTP. Bearer catalog, quote, buy, and poll. Top up your wallet from $1.

Base URL
https://getverifycode.com/api/v1
Money
USD integer cents. The client cannot set the price.
Auth
Bearer API key on private routes

One temporary number for one SMS verification.

Quick start

  1. 1

    Check API

    GET /catalog/meta

  2. 2

    Account

    Confirm email, create an API key, then fund the wallet on the website.

  3. 3

    Catalog

    Services (slug) → destinations → routes → quote

  4. 4

    Buy

    POST /activations → poll → cancel if unused

Create a key

Shown
Plaintext once
Replace
A new key replaces the old one
Expiry
One year

Sign in first. Then you can create a key.

Auth

Header
Authorization: Bearer YOUR_API_KEY
Public
Catalog and quote (when public API is on)
Header
Authorization: Bearer YOUR_API_KEY

Errors

401
Missing or invalid token
404
Missing resource or another user's resource
503
public_api_off
Typed error
{
  "error": {
    "code": "insufficient_funds",
    "message": "Insufficient available balance."
  }
}

Catalog

Access
Public. No token.
Returns
Retail cents and availability only
Omits
Stock counts, wholesale, supplier names
slug
Use service slug in path segments (example whatsapp)
GET/catalog/servicesPublic
curl
curl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/services'
200
{
  "services": [
    { "slug": "whatsapp", "name": "WhatsApp", "from_cents": 52, "currency": "USD" }
  ]
}
GET/catalog/countriesPublic
curl
curl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/countries'
200
{
  "countries": [
    { "iso": "US", "name": "United States", "dial": "+1" }
  ]
}
GET/catalog/countries/{country}/servicesPublic
curl
curl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/countries/US/services'
200
{
  "country": "US",
  "services": [
    { "slug": "whatsapp", "name": "WhatsApp", "from_cents": 52, "currency": "USD" }
  ]
}

Packages

Flow
destinations → routes → quote → buy
Query
Required country (ISO-2). Optional fresh=1.
Use
Pass operator into quote and buy.
OperatorLabelNotes
route_openOpen stockDefault open stock
route_rankedRanked deliveryStronger delivery history
route_virtualVirtualSome apps reject hosted numbers
route_wideWide stockExtra stock lane
route_usUS mobileUnited States only
GET/catalog/services/{service}/destinationsPublic
curl
curl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/services/whatsapp/destinations'
200
{
  "service": "whatsapp",
  "destinations": [
    { "iso": "US", "name": "United States", "dial": "+1", "retail_cents": 111, "currency": "USD" }
  ]
}
GET/catalog/services/{service}/routesPublic
curl
curl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/services/whatsapp/routes?country=US'
200
{
  "service": "whatsapp",
  "country": "US",
  "packages": [
    { "operator": "route_ranked", "label": "Ranked delivery", "retail_cents": 111, "currency": "USD" },
    { "operator": "route_open", "label": "Open stock", "retail_cents": 312, "currency": "USD" }
  ]
}

Quote

Required
service, country, operator
GET/catalog/quotePublic
curl
curl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/quote?service=whatsapp&country=US&operator=route_open'
200
{
  "service": "whatsapp",
  "country": "US",
  "operator": "route_open",
  "retail_cents": 312,
  "currency": "USD",
  "lane": "Open stock"
}

Buy / poll

idempotency_key
Client-generated (UUID or order id). Min 8 chars. New key per purchase. Same key only on retry.
operator
From routes (example route_open)
retail_cents
Ignored if sent
Poll
Every ~2.5s while pending. Read sms[].otp_code.
Window
About 20 minutes
POST/activationsBearer
Body
{
  "service": "whatsapp",
  "country": "US",
  "operator": "route_open",
  "idempotency_key": "buy-2026-09-18-01"
}
curl
curl -s -X POST -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"service":"whatsapp","country":"US","operator":"route_open","idempotency_key":"buy-1"}' \
  'https://getverifycode.com/api/v1/activations'
201
{
  "activation": {
    "id": 88,
    "status": "pending",
    "service": "whatsapp",
    "country": "US",
    "operator": "route_open",
    "phone_number": "+12015550148",
    "retail_cents": 312,
    "currency": "USD",
    "expires_at": "2026-09-18T12:20:00+00:00",
    "sms": []
  }
}
GET/activations/{id}Bearer, owner
curl
curl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/activations/88'
200 received
{
  "activation": {
    "id": 88,
    "status": "received",
    "service": "whatsapp",
    "country": "US",
    "operator": "route_open",
    "phone_number": "+12015550148",
    "retail_cents": 312,
    "currency": "USD",
    "expires_at": "2026-09-18T12:20:00+00:00",
    "completed_at": "2026-09-18T12:04:12+00:00",
    "sms": [
      {
        "sender": "WhatsApp",
        "body": "Your code is 482193",
        "otp_code": "482193",
        "received_at": "2026-09-18T12:04:12+00:00"
      }
    ]
  }
}
POST/activations/{id}/cancelBearer, owner
curl
curl -s -X POST -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://getverifycode.com/api/v1/activations/88/cancel'

Status

pending
Number live. Cents held.
received
SMS stored. Hold captured.
canceled
Hold released.
timeout
Window ended. Hold returned.
failed
Sale refused. Hold returned.
refunded
Admin credit after pending or received.

Refunds

Public
POST /activations/{id}/cancel while pending
After received
No public refund route
Website
Ask for a refund opens a billing ticket

Account

GET/meBearer
curl
curl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/me'
200
{
  "user": {
    "id": 1,
    "name": "Ada",
    "email": "ada@example.com",
    "email_verified": true,
    "wallet": {
      "available_cents": 1000,
      "held_cents": 0,
      "currency": "USD"
    }
  }
}

Wallet

available_cents
Spendable
held_cents
Reserved for a live number
Top up
Website only
GET/walletBearer
curl
curl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/wallet'
200
{
  "available_cents": 1000,
  "held_cents": 0,
  "currency": "USD"
}

API keys

Fields
id, expires_at
Create
Also returns plaintext token once
GET/api-keysBearer
curl
curl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/api-keys'
200
{
  "keys": [
    { "id": 4, "expires_at": "2027-09-18T12:00:00+00:00" }
  ]
}
POST/api-keysBearer
curl
curl -s -X POST -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/api-keys'
201
{
  "key": { "id": 5, "expires_at": "2027-09-18T12:00:00+00:00" },
  "token": "5|plaintext-shown-once"
}
DELETE/api-keys/{id}Bearer, owner
curl
curl -s -X DELETE -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/api-keys/5'
200
{
  "ok": true
}

Limits

Catalog
60 / min
Buy
30 / hour / account
Cancel
20 / min
Create key
10 / min
Revoke key
20 / min
Activation window
About 20 minutes

Error codes

insufficient_funds
422
wallet_frozen
403
banned
403
max_purchase_exceeded
Price over account max
negative_margin
Unavailable at a safe price
provider_unavailable
Paused or busy
provider_error
Sale failed. Retry or change package.
no_stock
Package empty
invalid_country
Unknown country
invalid_operator
Unknown package
not_cancellable
Not pending
public_api_off
503

Support: support@getverifycode.com. Send a token prefix, never the full secret. Or open Contact.

FAQ

Developer FAQ

  • Call GET /api/v1/catalog/meta. If public_api is off, wait or use the website shop on Get started. Get started

  • Sign in, confirm your email, then create a key from the control on this page. The secret shows once. Use it as a Bearer token on /api/v1.

  • Top up on the website after you sign in. The API spends wallet cents. There is no separate API billing account. Get started

  • No. The public API sells private paid activations only. Shared free inboxes stay on the free numbers page. Free numbers

GetVerifyCode

Ready to receive a code?

Browse services for a short activation, or open rentals when you need the same number for days. Top up your wallet from $1. Unused activation holds return if no SMS arrives.

Get started