Phone Validation

GET /v1/phone/validate

Validate and normalize a phone number. Returns the E.164 format, country of origin, carrier information, and line type (mobile or landline).

Query Parameters

Parameter	Type	Required	Description
number	string	Yes	The phone number to validate (any format).

cURL

curl "https://sendapi.co/v1/phone/validate?number=07700900000" \
  -H "Authorization: Bearer sk_live_123456789"

Node.js

const result = await client.phone.validate('07700900000');
console.log(result.e164); // "+447700900000"

Python

result = client.phone.validate("07700900000")
print(result.e164)  # "+447700900000"

Response

{
  "input": "07700900000",
  "valid": true,
  "e164": "+447700900000",
  "national_format": "07700 900000",
  "country": "United Kingdom",
  "country_code": "GB",
  "dial_prefix": "+44",
  "line_type": "mobile",
  "carrier": "EE"
}

Invalid Number Response

{
  "input": "123",
  "valid": false,
  "error": "Number too short to be valid"
}

Line Types

Type	Description
mobile	Mobile phone — eligible for SMS and WhatsApp
landline	Fixed-line — can only receive voice calls
voip	VoIP number — may not receive SMS in all regions
unknown	Line type could not be determined

Pre-validate Before Sending

Use this endpoint to validate and normalize phone numbers from user input before adding them to your database. Storing numbers in E.164 format ensures compatibility with all SendAPI endpoints.