Loading
Loading
Our Phone Number Validation API verifies phone numbers and retrieves detailed metadata including carrier name, line type, geographic location, time zones, and multiple format standards. The API checks if numbers are valid according to international numbering plans, identifies whether they are mobile, landline, or VoIP, and returns standardized formats like E.164 and RFC3966. Use it to block fake signups with disposable numbers, clean contact lists before SMS campaigns, or verify user data during registration. Supports phone numbers from 200+ countries in both international and local formats.
Designed for seamless integration, the API accepts phone numbers in international format, local format with a two-letter country code, or IDD format (country exit codes like 00 or 011) with a dialer region. It returns carrier details, geographic location, and time zones in a single response. Whether you need to validate a phone number validator for user onboarding, a carrier lookup API for SMS routing, or a mobile carrier detector to flag VoIP and disposable numbers, our Phone Number Validation API provides reliable, real-time data in a single endpoint.
Need to verify phone numbers in batches? Check out the Bulk Phone Number Validation API to process up to 100 numbers per request.
Identify the telecom carrier associated with any phone number. Use carrier data to optimize SMS routing, estimate delivery costs, or flag numbers registered with carriers known for disposable and temporary lines.
Detect whether a number is mobile, landline, VoIP, toll-free, premium rate, or any other recognized classification. Filter out VoIP numbers commonly used for fake signups, prevent SMS delivery to landline numbers, and identify toll-free or premium rate numbers before placing calls.
Convert any phone number into four standardized formats: E.164 for storage and APIs, international for display, national for local use, and RFC3966 for tel: links in HTML. Normalize inconsistent user input into clean, uniform data.
Retrieve the country, city, or region associated with a number along with applicable IANA time zones. Use location data to schedule outreach at appropriate hours, detect geographic mismatches during fraud checks, or personalize user experiences.
Two levels of validation. The possible field confirms the number has a valid length and prefix structure. The valid field confirms it matches the country's official numbering plan. A number can be possible but not valid.
Validate phone numbers from 200+ countries with automatic country code detection. Accept numbers in international format with a + prefix or in local format paired with a two-letter country code.
$ pip install requestsimport requests
import json
url = "https://api.apifreaks.com/v1.0/phone/validation"
payload = json.dumps({
"number": "+14155552671"
})
headers = {
'Content-Type': 'application/json',
'X-apiKey': 'API-KEY'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
The simplest way to validate a phone number is to provide it in international format with a + prefix. The API automatically detects the country and validates against that country's numbering rules.
# Response { "raw_input": { "number": "+14155552671" }, "possible": true, "valid": true, "country_prefix": 1, "national_number": 4155552671, "country_code": "US", "location": "San Francisco, CA", "time_zones": [ "America/Los_Angeles" ], "line_type": "FIXED_LINE_OR_MOBILE", "formats": { "E164": "+14155552671", "International": "+1 415-555-2671", "National": "(415) 555-2671", "RFC3966": "tel:+1-415-555-2671" }, "area_code_length": 3, "ndc_length": 3, "can_be_internationally_dialled": true }curl -X 'POST' 'https://api.apifreaks.com/v1.0/phone/validation' -H 'Content-Type: application/json' -H 'X-apiKey: YOUR_API_KEY' -d '{ "number": "+14155552671" }'
To use the Phone Number Validation API, API credits are required. Charges apply only for successful queries, defined by a 2xx status code. If a request results in a 4xx or 5xx status code, no credits will be deducted, and any credits already charged will be refunded.
For each successful request, 2 credit will be charged.
Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.