Telephone Data
US area code lookup (NANPA NPA database) and international country dialing codes (ITU E.164). Search by area code, state, or country.
Area Code Lookup
GET /api/v1/pro/telephone/area-code Requires API key | npa | 3-digit area code (e.g. 212, 415) |
| state | Two-letter state code |
| city | City name (partial match) |
curl -H "Authorization: Bearer pro_YOUR_KEY" \
"https://api.verilexdata.com/api/v1/pro/telephone/area-code?npa=212"Response
{
"dataset": "telephone",
"type": "area_codes",
"count": 1,
"data": [
{
"npa": "212",
"npa_type": "Geographic",
"city": "New York",
"state": "NY",
"country": "US",
"latitude": 40.7128,
"longitude": -74.0060,
"timezone": "America/New_York",
"overlay": false,
"in_service": true,
"in_service_date": "1947-01-01",
"status": "IN SERVICE"
}
]
}Phone Number Validation
Validate and parse any phone number worldwide. Returns formatted versions (E.164, international, national, RFC 3966), number type (mobile, fixed line, toll-free, VOIP, etc.), and country/region. US numbers are enriched with area code data.
GET /api/v1/pro/telephone/validate Requires API key | number | Phone number (E.164 format preferred, e.g. +12125551234) |
| region | Default region for parsing (default: US). ISO 3166-1 alpha-2. |
curl -H "Authorization: Bearer pro_YOUR_KEY" \
"https://api.verilexdata.com/api/v1/pro/telephone/validate?number=%2B12125551234"Response
{
"dataset": "telephone",
"type": "validation",
"valid": true,
"possible": true,
"input": "+12125551234",
"formatted": {
"e164": "+12125551234",
"international": "+1 212-555-1234",
"national": "(212) 555-1234",
"rfc3966": "tel:+1-212-555-1234"
},
"country_code": 1,
"region": "US",
"number_type": "FIXED_LINE_OR_MOBILE",
"area_code": {
"npa": "212",
"npa_type": "General Purpose Code",
"city": "New York",
"state": "NY",
"overlay": true,
"in_service": true
},
"portability_warning": "This result reflects the original NANPA assignment..."
}Number types: FIXED_LINE, MOBILE, FIXED_LINE_OR_MOBILE, TOLL_FREE, PREMIUM_RATE, SHARED_COST, VOIP, PERSONAL_NUMBER, PAGER, UAN, VOICEMAIL, UNKNOWN
Number portability notice
Area code data reflects the original NANPA assignment for each NPA. Due to number portability (LNP), a phone number's area code may no longer correspond to its current geographic location or carrier. A number originally assigned to area code 212 (New York) could now be active in California.
Number portability lookup is coming soon. This will let you determine the current carrier and serving location for any US phone number, regardless of its original area code assignment.
Country Dialing Code Lookup
GET /api/v1/pro/telephone/country-code Requires API key | code | E.164 dialing code (e.g. 1, 44, 86) |
| country | ISO 3166-1 alpha-2 code (e.g. US, GB, CN) |
| name | Country name (partial match) |
curl -H "Authorization: Bearer pro_YOUR_KEY" \
"https://api.verilexdata.com/api/v1/pro/telephone/country-code?code=44"Response
{
"dataset": "telephone",
"type": "country_codes",
"count": 1,
"data": [
{
"country_code": "44",
"country_name": "United Kingdom",
"iso_alpha2": "GB",
"iso_alpha3": "GBR",
"region": "Europe"
}
]
}