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

409

Can't cancel this number yet. New rentals are locked for a few minutes to prevent abuse. Please wait and try again.

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