v3

latestOpenAPI 3.1.02026-08-087684214.2 KB
verification

Send Verification

Send a 6-digit verification code to a phone number via SMS.

Use this instead of sending your own code over POST /v1/messages: it routes through carrier-registered sender IDs, so it reaches countries where plain application SMS from a US long code is not deliverable (e.g. Greece, UAE, the Philippines, the UK).

The code is always 6 digits, expires after 10 minutes, and allows up to 3 check attempts. None of these are configurable.

Billing. Sending a code costs the standard outbound SMS rate for the destination country. A successful POST /v1/verify/check adds a $0.05 verification fee; failed, expired, and exhausted checks are not charged.

Destination coverage. A small number of countries are unavailable and return 400. Email founders@agentphone.to if you need access to one.

post/v1/verify/send

Request body

phone_numberstring required

Phone number in E.164 format (e.g. +639277372243)

Response

Successful Response

verification_idstring required

Pass this to POST /v1/verify/check along with the code the user entered.

statusstring required

Verification status. pending until the code is checked.