Getting Started

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.

GET

/api/services

Get services

This will return a list of services that are available for the user to rent.

Required attributes

None

Possible errors

None

curl https://verifysms.io/api/services

Response (200)

{
  "zf": {
    "name": "Coinbase",
    "cost": 1,
    "in_stock": true
  },
  "ty": {
    "name": "DoorDash",
    "cost": 0.5,
    "in_stock": true
  }
}

GET

/api/balance

Get balance

This endpoint will retrieve the current balance (in USD) of the user.

Required attributes

None

Possible errors

401

Invalid API key

curl https://verifysms.io/api/balance \
	-H "API-KEY: {api_key}"

Response (200)

120.87

POST

/api/rent

Rent a number

This endpioint will rent a phone number and subtract your balance into your locked balance.

Required attributes

codestring

Service code. For example 'bq' for Signal verification.

carriersstring[] (optional)

Optional carriers array to select from. Possible values: 'verizon', 'att', 'tmobile'. If none are provided, a random carrier will be selected.

Possible errors

400

Invalid request body (missing code, invalid carriers, invalid days/auto_renew, or invalid carrier).

401

Invalid API key

402

Insufficient balance

404

Service not found

409

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"}'

Response (200)

{
  "number": "4345122324",
  "cost": 0.1,
  "code": "bq",
  "service": "Signal",
  "transaction_id": "b3f0cdaa-d50f-409d-b032-08bb61671379"
}

GET

/api/code

Get code

This endpoint will retrieve the code that was received from the rented number. If you want to receive the code via webhook, please add your webhook URL to your profile settings.

Required attributes

transaction_iduuid

ID of the transaction to cancel. This ID is returned when you rent a number.

Possible errors

400

Transaction ID is missing; Transaction cancelled

401

Invalid API key

404

Transaction not found

409

Code not received yet

curl https://verifysms.io/api/code?transaction_id=b3f0cdaa-d50f-409d-b032-08bb61671379 \
	-H "API-KEY: {api_key}"

Response (200)

POST

/api/cancel

Cancel a number

This endpioint will cancel your phone rental and return the locked balance to your balance.

Required attributes

transaction_iduuid

ID of the transaction to cancel. This ID is returned when you rent a number.

Possible errors

400

Transaction ID is missing; Can't cancel a transaction that received a code; Transaction already cancelled

401

Invalid API key

404

Transaction not found

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"}'

Response (200)

None

Service Codes

Below is a table of all available service codes and their descriptions:

Code	Description
jn	Badoo
df	Google / Gmail / Youtube
jx	TikTok
kh	Microsoft / Outlook / Hotmail
kj	WeChat
fwl	Currently.com
hks	Service not listed
hqj	Pixels.xyz
lh	Yahoo
jnk	Resy.com
kl	Amazon / AWS
klx	Google Messenger
lrc	Truth Social
rdt	Blastbucks
ls	Snapchat
mq	Temu
th	TrapCall
np	Lyft
nx	eBay
wc	Cash App
nxd	Chevron / TexaCo
pz	Discord
ylm	College Pulse
ypd	Noonlight
yxt	PVC
qr	Eneba
vt	Craigslist
ctn	FetLife
zxc	LAA
gn	Hinge
wl	LinkedIn
hs	AOL
xgp	Uber
gbc	Current.com
xh	Viber
xm	Mercari
hxn	Credit Karma
jf	LINE messenger
zf	Coinbase
khb	League of Legends
vj	Nike
plv	Chase
xz	Hily
kv	Twitter
rwz	Neocrypto
kvj	Swagbucks / InboxDollars / MyPoints / ySense / Noones / Adgate Survey
fy	Apple
kwj	Coca-Cola
lmv	Ring4
wf	PayPal
nvl	Kudos
pmy	Gaintplay
pwx	Sideline / Index by Pinger
qc	Steam
rq	Google Voice
sb	Linode
tm	Grindr
bq	Signal
bw	Fiverr
bx	OpenAI / ChatGPT
ste	Seated
sf	Zillow
zkq	Venmo
dj	CrowdTap
dm	Poshmark
gk	OkCupid
gy	VKontakte
ng	WhatsApp
tg	Telegram
bhr	Claude AI
zabc	Google Chat
zjad	Rove Miles
zmma	Citi Bank
ty	DoorDash
fbb	Facebook
ei	Bumble
yfz	Tinder
zlw	TextFree
zr	Plenty of Fish
wtnt	Whatnot
zhm	Etsy
fwk	Ibotta
hyn	Textr
mg	Blizzard / Battle.net
rn	Timewall
yq	JD.com
zqxp	AARP Rewards
ctps	Capital One Shopping
wdk	Ticketmaster
fc	Walmart
rp	Instagram
hjb	Gopuff
aamd	Ashley Madison