Skip to main content
Phone Validation verifies phone numbers by checking validity, format, and carrier information to ensure numbers are active and reachable.

​
Coverage

  • Global: Validates phone numbers for 237 countries and territories worldwide
  • Number types: Supports mobile, landline, and VoIP numbers for business and personal use
  • Carrier information: Returns network operator, country, and porting details
  • Format standardization: Provides numbers in both international and national formats

​
Available Endpoints

Phone Validation provides one primary API endpoint:

​
Getting Started

  1. Create an API key if you don’t have one
  2. Choose your request format (international format or with Country parameter)
  3. Make your first request using the endpoint documentation above
Here’s a simple example request for the Individual Validate endpoint: 
curl --request GET \
  --url https://api.addressy.com/PhoneNumberValidation/Interactive/Validate/v2.20/json6.ws

​
What Phone Validation Returns

Phone Validation provides:
  • Validation status indicating whether the phone number is valid (Yes, No, or Maybe)
  • Phone number formatted in both international and national formats
  • Network operator information including carrier name and country
  • Number type classification (Mobile, Landline, or VoIP)
  • Optional porting and roaming details for mobile numbers
Response should be in the following format: 
{
  "Items": [
    {
      "PhoneNumber": "+441244657333",
      "RequestProcessed": true,
      "IsValid": "Yes",
      "NetworkCode": "",
      "NetworkName": "BT",
      "NetworkCountry": "GB",
      "NationalFormat": "01244 657333",
      "CountryPrefix": 44,
      "NumberType": "Landline"
    }
  ]
}
And you can use this information below to interpret the response fields:

​
Validation Results

FieldTypeDescription
IsValidstringWhether the number is valid: Yes (valid), No (invalid), or Maybe (full validation couldn’t be performed due to temporary cellular network issues)
RequestProcessedbooleanReturns true if the request was successfully processed on the network, false if validation attempt was unsuccessful

​
Phone Number Formats

FieldTypeDescription
PhoneNumberstringThe phone number in international format
NationalFormatstringThe phone number in domestic network format (useful for dialing within the same country)
CountryPrefixintegerThe country prefix that must be prepended when dialing internationally

​
Network Information

FieldTypeDescription
NetworkCodestringThe current operator code serving the supplied number
NetworkNamestringThe name of the current operator serving the supplied number
NetworkCountrystringThe country code of the operator
NumberTypestringThe type of number detected: Mobile, Landline, or VoIP

​
Mobile-Specific Fields (Optional)

FieldTypeDescription
MccMncstringMobile country code and mobile network code concatenated
PortedstringReturns True if the number has been ported to another network
PortedNetworkNamestringThe network name that the mobile number is currently registered with after porting
PortedNetworkCountrystringThe country code of the network that the mobile number has been ported to
RoamingstringReturns True if the number is currently roaming in another country
RoamingNetworkNamestringThe network name that the mobile number is currently registered with while roaming
RoamingNetworkCountrystringThe country that the mobile number is currently in while roaming
OriginalNetworkNamestringThe original network name that the mobile number was registered with
OriginalNetworkCountrystringThe original country code that the phone was registered with
Note: Mobile-specific fields (porting and roaming information) are only returned when applicable and available for the queried number.

​
Required Parameters

ParameterTypeDescription
KeystringYour API key to authenticate to the service
PhonestringThe phone number to validate

​
Optional Parameters

ParameterTypeDescription
CountrystringTwo- or three-digit ISO country code (e.g., GB/GBR for UK, US/USA for USA). Required if phone number is not in international format

​
Request Format Options

Phone Validation accepts numbers in two formats:International format (recommended):
  • Include country code with + prefix: +441244657333
  • No Country parameter needed
National format:
  • Omit country code: 01244657333
  • Must include Country parameter: Country=GBR
Both formats return identical validation results.
When an error occurs, the API returns an error response with the following structure:
FieldTypeDescription
ErrorstringThe error ID
DescriptionstringA description of the error
CausestringThe cause of the error
ResolutionstringActions to resolve the error

​
Common Error Codes

Status CodeMeaningCommon Causes
400Bad RequestInvalid parameters, malformed phone number, missing required Phone parameter
401UnauthorizedInvalid or missing API key
403ForbiddenAPI key doesn’t have permission for Phone Validation, or daily limit exceeded
500Internal Server ErrorServer-side issue, temporary service disruption
Tip: Check the Resolution field for specific steps to fix the error. For more details on error responses, see Individual Validate in API documentation.
Note: Phone Validation uses a three-step process combining Loqate’s custom libraries with the Home Location Register (HLR) database to verify phone number validity and carrier information.

​
Try Phone Validation

Test Phone Validation using the Individual Validate Playground to make your first request.

​
FAQ

Both methods work identically and return the same validation results. However, international format is recommended for simplicity:
  • International format: Include the country code with + prefix (e.g., +441244657333). No Country parameter needed
  • National format: Omit the country code (e.g., 01244657333) and include the Country parameter (e.g., Country=GBR)
International format is cleaner and reduces the chance of errors from missing or incorrect Country parameters.
An IsValid value of Maybe indicates that full validation couldn’t be performed, typically due to:
  • Temporary cellular network issues
  • Failures in the validation procedure on the carrier side
When you receive Maybe, the number format and country code are valid, but the system couldn’t confirm if the specific number is currently active. You may want to retry the validation or treat these numbers cautiously in your workflow.
Yes, Phone Validation supports all major phone number types:
  • Mobile: Cellular phone numbers with optional porting and roaming details
  • Landline: Fixed-line telephone numbers
  • VoIP: Voice over IP numbers
The service works for both business and personal phone numbers across 237 countries and territories globally.
For mobile numbers, Phone Validation returns standard network information plus optional mobile-specific details:
  • Current network operator and country
  • Whether the number has been ported to another carrier
  • Porting details (if applicable)
  • Roaming status and location (if currently roaming)
  • Original network registration information
These fields help you understand the number’s current status and carrier, which is useful for routing messages or understanding deliverability.