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