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