To get started with the API, you need to create an account and obtain an API key. You can do this by signing up for an account.
Once you have an account, you can get your API key in the profile section. This key will be used to authenticate your requests to the API. The same page is where you set a webhook URL. A Discord webhook URL receives each code as an embed.
/api/services
Returns every service, keyed by service code, with its price in USD (cost) and how many numbers are currently available to rent for it (stock). Send your API-KEY header to get your custom prices; without it, the standard prices are returned.
None
None
curl https://verifysms.io/api/services{
"zf": {
"name": "Coinbase",
"cost": 1,
"stock": 632
},
"ty": {
"name": "DoorDash",
"cost": 0.5,
"stock": 0
}
}/api/balance
This endpoint will retrieve the current balance (in USD) of the user.
None
Invalid API key
curl https://verifysms.io/api/balance \
-H "API-KEY: {api_key}"120.87/api/rent
This endpioint will rent a phone number and subtract your balance into your locked balance.
Service code. For example 'bq' for Signal verification.
Optional carriers array to select from. Possible values: 'verizon', 'att', 'tmobile'. If none are provided, a random carrier will be selected.
Invalid request body (missing code, invalid carriers, invalid days/auto_renew, or invalid carrier).
Invalid API key
Insufficient balance
Service not found
No numbers available right now.
curl https://verifysms.io/api/rent \
-X POST \
-H "API-KEY: {api_key}" \
-H "Content-Type: application/json" \
-d '{"code":"bq"}'{
"number": "4345122324",
"cost": 0.1,
"code": "bq",
"service": "Signal",
"transaction_id": "b3f0cdaa-d50f-409d-b032-08bb61671379"
}/api/code
This endpoint retrieves the code received for a rented number. To receive codes as they arrive, set a webhook URL in your profile. Discord webhook URLs are supported and are delivered as an embed with the same fields (id, code, message, service, sender).
ID of the transaction to cancel. This ID is returned when you rent a number.
Transaction ID is missing; Transaction cancelled
Invalid API key
Transaction not found
Code not received yet
curl https://verifysms.io/api/code?transaction_id=b3f0cdaa-d50f-409d-b032-08bb61671379 \
-H "API-KEY: {api_key}"422316/api/cancel
This endpioint will cancel your phone rental and return the locked balance to your balance.
ID of the transaction to cancel. This ID is returned when you rent a number.
Transaction ID is missing; Can't cancel a transaction that received a code; Transaction already cancelled
Invalid API key
Transaction not found
Can't cancel this number yet. New rentals are locked for 5 minutes to prevent abuse. Please wait and try again. Returned when the rental is under 5 minutes old and your recent rentals have mostly been cancelled; wait out the lock and retry.
curl https://verifysms.io/api/cancel \
-X POST \
-H "API-KEY: {api_key}" \
-H "Content-Type: application/json" \
-d '{"transaction_id":"b3f0cdaa-d50f-409d-b032-08bb61671379"}'None
Below is a table of all available service codes and their descriptions:
| Code | Description |
|---|---|
| aamd | Ashley Madison |
| bhr | Claude AI |
| bq | Signal |
| dj | CrowdTap |
| jx | TikTok |
| khb | League of Legends |
| kj | |
| kl | Amazon / AWS |
| klx | Google Messenger |
| kv | |
| kwj | Coca-Cola |
| lh | Yahoo |
| lmv | Ring4 |
| nxd | Chevron / TexaCo |
| plv | Chase |
| qc | Steam |
| qr | Eneba |
| rn | Timewall |
| rdt | Blastbucks |
| wc | Cash App |
| wdk | Ticketmaster |
| wf | PayPal |
| wtnt | Whatnot |
| xgp | Uber |
| xh | Viber |
| xm | Mercari |
| xz | Hily |
| yfz | Tinder |
| ylm | College Pulse |
| ypd | Noonlight |
| yq | JD.com |
| yxt | PVC |
| zabc | Google Chat |
| zjad | Rove Miles |
| bw | Fiverr |
| bx | OpenAI / ChatGPT |
| ctn | FetLife |
| ctps | Capital One Shopping |
| df | Google / Gmail / Youtube |
| dm | Poshmark |
| ei | Bumble |
| fbb | |
| fc | Walmart |
| fwk | Ibotta |
| fwl | Currently.com |
| fy | Apple |
| pmy | Gaintplay |
| pwx | Sideline / Index by Pinger |
| pz | Discord |
| gbc | Current.com |
| gk | OkCupid |
| gn | Hinge |
| gy | VKontakte |
| hjb | Gopuff |
| hks | Service not listed |
| jnk | Resy.com |
| zf | Coinbase |
| zkq | Venmo |
| zlw | TextFree |
| wl | |
| kvj | Swagbucks / InboxDollars / MyPoints / ySense / Noones / Adgate Survey |
| rp | |
| rq | Google Voice |
| rwz | Neocrypto |
| sb | Linode |
| sf | Zillow |
| ste | Seated |
| tg | Telegram |
| th | TrapCall |
| tm | Grindr |
| ty | DoorDash |
| vj | Nike |
| vt | Craigslist |
| lrc | Truth Social |
| ls | Snapchat |
| mg | Blizzard / Battle.net |
| mq | Temu |
| ng | |
| np | Lyft |
| nvl | Kudos |
| nx | eBay |
| zhm | Etsy |
| hqj | Pixels.xyz |
| hs | AOL |
| hxn | Credit Karma |
| hyn | Textr |
| jf | LINE messenger |
| jn | Badoo |
| kh | Microsoft / Outlook / Hotmail |
| zmma | Citi Bank |
| zqxp | AARP Rewards |
| zr | Plenty of Fish |
| zxc | LAA |