Phone Validation

Verify if a phone number is real, active, and what type of line it is.

Credits: 1 per request

Request

POST /v1/validate-phone

Parameters

Field	Type	Required	Description
phone	string	Yes	Phone number (E.164 format preferred)

Example

curl -X POST https://api.braidisdata.com/v1/validate-phone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+15551234567"}'

Response

{
  "success": true,
  "credits_used": 1,
  "credits_remaining": 999,
  "data": {
    "phone": "+15551234567",
    "valid": true,
    "active": true,
    "line_type": "mobile",
    "carrier": "T-Mobile",
    "country_code": "US",
    "national_format": "(555) 123-4567"
  }
}

Response Fields

Field	Type	Description
valid	boolean	Whether the number is a valid phone format
active	boolean	Whether the number is currently active
line_type	string	mobile, landline, voip, toll_free, unknown
carrier	string	The phone carrier name
country_code	string	ISO 3166-1 alpha-2 country code
national_format	string	Human-readable formatted number

Line Types

Type	Description
mobile	Cell phone
landline	Traditional wired phone
voip	Voice over IP (Google Voice, etc.)
toll_free	800/888/877 numbers
unknown	Could not be determined