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 (coming soon, for now all errors are 500)

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 (coming soon, for now all errors are 500)

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

servicestring

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 (coming soon, for now all errors are 500)

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

Service not available

curl https://verifysms.io/api/rent \
	-H "API-KEY: {api_key}" \
	-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 (coming soon, for now all errors are 500)

400

Transaction ID is missing.

401

Invalid API key

404

Transaction not found

409

Code not received yet

410

Transaction cancelled

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 (coming soon, for now all errors are 500)

400

Transaction ID is missing.

401

Invalid API key

404

Transaction not found

409

Can't cancel a transaction that received a code

410

Transaction already cancelled

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

Response (200)

None

POST

/api/reactivate

Reactivate a number

This endpoint will reactivate a phone number after it has received a code, allowing it to receive one additional code. The reactivation cost (25% of the original rental cost) will be moved from your balance to locked balance and charged when the next code arrives.

Required attributes

transaction_iduuid

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

Possible errors (coming soon, for now all errors are 500)

400

Transaction ID is missing.

400

Transaction does not support reactivation

401

Invalid API key

402

Insufficient balance for reactivation

404

Transaction not found

409

Transaction has not received a code yet

410

Transaction is cancelled or already reactivated

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