Generate a test phone number

Generate a random test phone number and its corresponding verification code. Works without authentication (unauthenticated access is heavily rate limited). Also accepts demo/sandbox API keys.

Test phone numbers use reserved ranges that never send real SMS:

• US: +1{area_code}555-01xx (NANP fictional block)
• Global: +99901xxxxxxx (ITU E.164 test range)

The verification code is always the last 6 digits of the phone number.

POST /v2/sandbox/phone-number

Generate a test phone number

cURL

curl --request POST \
  --url https://api.connect.verifyyou.com/v2/sandbox/phone-number \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "us",
  "area_code": "210"
}
'

200

{
  "phone_number": "[phone]",
  "verification_code": "550142"
}

Authorizations

API-KEY · string · header · required

Your VerifyYou API key.

Body

application/json

type · enum<string> · default: global

Type of test phone number to generate.

Available options: us, global

Example:

"us"

area_code · string · default: 210

3-digit US area code (only used when type is us).

Example:

"210"

Response

200

application/json

Test phone number generated successfully.

phone_number · string

The generated test phone number in E.164 format.

Example:

"[phone]"

verification_code · string

The verification code for this test number (last 6 digits).

Example:

"550142"