Live Number Validation

This endpoint will check if the mobile phone number is of the correct format and then do a HLR request to see if the phone number is live/active.

If all you care about is making sure the phone number is in the correct format, use this free endpoint

Endpoint

[POST] https://usenotifier.com/api/validate/live

This endpoint costs 1 credit

Example Request

$response = Http::withToken('YOUR_API_KEY')
               ->post('https://usenotifier.com/api/validate/live', [
                  "phoneNumber" => "07700900389",
                  "countryCode" => "GB",
                ]);

$client = new Client();
$headers = [
  'Accept' => 'application/json',
  'Authorization' => 'Bearer YOUR_API_KEY',
  'Content-Type' => 'application/x-www-form-urlencoded'
];
$options = [
'form_params' => [
  'phoneNumber' => '07700900389',
  'countryCode' => 'GB'
]];
$request = new Request('POST', 'https://usenotifier.com/api/validate/live', $headers);
$res = $client->sendAsync($request, $options)->wait();
echo $res->getBody();

Read the Authentication docs to get your API KEY

phoneNumber: required

The mobile phone number in any format.

countryCode: required

The 2 character ISO 3166 country code you want to validate the phone number against. Get a list of valid codes.

Example Response

"phone_number": "+447700900389",
"isActiveNumber": true,
"network": "EE Limited ( TM)",
"ported": false,
"type": "mobile",
"valid_format": true,
"country": "GB",
"credits_used": 1

This endpoint also makes use of this Free Phone Number Format endpoint so we make sure that the format is correct before attempting a HLR request. This means that if the number you provide is garbage or the format of a different country than you expect, you won't be charged any credits.

PreviousPhone Number Format Validation

Last updated 2 years ago

Was this helpful?