One temporary number for one SMS verification.
Quick start
- 1
Check API
GET /catalog/meta
- 2
Account
Confirm email, create an API key, then fund the wallet on the website.
- 3
Catalog
Services (slug) → destinations → routes → quote
- 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)
Authorization: Bearer YOUR_API_KEY
Errors
- 401
- Missing or invalid token
- 404
- Missing resource or another user's resource
- 503
- public_api_off
{
"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)
/catalog/servicesPubliccurl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/services'
{
"services": [
{ "slug": "whatsapp", "name": "WhatsApp", "from_cents": 52, "currency": "USD" }
]
}/catalog/countriesPubliccurl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/countries'
{
"countries": [
{ "iso": "US", "name": "United States", "dial": "+1" }
]
}/catalog/countries/{country}/servicesPubliccurl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/countries/US/services'
{
"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.
| Operator | Label | Notes |
|---|---|---|
| route_open | Open stock | Default open stock |
| route_ranked | Ranked delivery | Stronger delivery history |
| route_virtual | Virtual | Some apps reject hosted numbers |
| route_wide | Wide stock | Extra stock lane |
| route_us | US mobile | United States only |
/catalog/services/{service}/destinationsPubliccurl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/services/whatsapp/destinations'
{
"service": "whatsapp",
"destinations": [
{ "iso": "US", "name": "United States", "dial": "+1", "retail_cents": 111, "currency": "USD" }
]
}/catalog/services/{service}/routesPubliccurl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/services/whatsapp/routes?country=US'
{
"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
/catalog/quotePubliccurl -s -H 'Accept: application/json' 'https://getverifycode.com/api/v1/catalog/quote?service=whatsapp&country=US&operator=route_open'
{
"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
/activationsBearer{
"service": "whatsapp",
"country": "US",
"operator": "route_open",
"idempotency_key": "buy-2026-09-18-01"
}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'{
"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": []
}
}/activations/{id}Bearer, ownercurl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/activations/88'
{
"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"
}
]
}
}/activations/{id}/cancelBearer, ownercurl -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
/meBearercurl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/me'
{
"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
/walletBearercurl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/wallet'
{
"available_cents": 1000,
"held_cents": 0,
"currency": "USD"
}API keys
- Fields
- id, expires_at
- Create
- Also returns plaintext token once
/api-keysBearercurl -s -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/api-keys'
{
"keys": [
{ "id": 4, "expires_at": "2027-09-18T12:00:00+00:00" }
]
}/api-keysBearercurl -s -X POST -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/api-keys'
{
"key": { "id": 5, "expires_at": "2027-09-18T12:00:00+00:00" },
"token": "5|plaintext-shown-once"
}/api-keys/{id}Bearer, ownercurl -s -X DELETE -H 'Accept: application/json' -H 'Authorization: Bearer YOUR_API_KEY' 'https://getverifycode.com/api/v1/api-keys/5'
{
"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.
