Eazita Developers

Lookup API: Validity Checker

Find out whether numbers are valid or invalid. Identify entries in a phone number database that don't follow standard number structure.

Request URL

https://api.eazita.com/lookup/basic/json

Query Parameter

KeyDescriptionDefault
api
REQUIRED | string
Your API keyNone
pass
REQUIRED | string
Your account passwordNone
number
REQUIRED | string
Phone number to lookup.
The numbers must be in international format.
None

Request Example

https://api.eazita.com/lookup/basic/json?api=YOUR_API_KEY&pass=YOUR_PASSWORD&number=TO_NUMBER
curl -X "POST" "https://api.eazita.com/lookup/basic/json" \
  -d "api=YOUR_API_KEY" \
  -d "pass=YOUR_PASSWORD" \
  -d "to=TO_NUMBER"

require_once("SMS_Portal.php");
$ezsms = new EZ_SMS("YOUR_API_KEY","YOUR_PASSWORD");

$ezsms->build_send(['to' => 'TO_NUMBER','from' => 'EZSMS','msg' => 'Test message via HTTP API.']);

$msg=$ezsms->execute_send();

if(count($msg)>0){ foreach($msg as $recipient=>$resp){
    echo "The status of message on ".$recipient." is ".$resp['status']." & the message id is ".$resp['messageid'].".";
} }

Response Example

HTTP/1.1 200 OK
Content-Type: application/json

{
	"code":1,
	"package":"basic",
	"data":[
		{
			"to":"923122699633",
			"code":1,
			"status":"Ok",
			"price":"0.000",
			"validity":"Valid",
			"NumberType":"MOBILE",
			"NumberFormat":
				{
					"international":"+923122699633",
					"national":"0312 2699633"
				},
			"location":
				{
					"continent":"AS - Asia",
					"country":"Pakistan",
					"country_iso":"PK",
					"country_code":"+92"
				}
		}
	]
}
			
HTTP/1.1 200 OK
Content-Type: application/json

{
	"code":1,
	"package":"basic",
	"data":[
		{
			"to":"123456",
			"code":1,
			"status":"Ok",
			"price":"0.000",
			"validity":"Invalid"
		}
	]
}

			
HTTP/1.1 200 OK
Content-Type: application/json

{
	"code":-1,
	"error":"Authentication Error - No credentials provided - api or pass missing."
}
			

After submitting the request you will receive a General Error Code in 'code' parameter.

General Error Codes

CodeError
1
No Error.
-1
Your request is incomplete and missing some mandatory parameters.
-2
There was an error processing your request in the Platform.
-3
The credentials you supplied is either invalid or disabled.
-4
The value of one or more parameters is invalid.
-5
You have exceeded the submission capacity of numbers allowed in a single request.
-6
Your account does not have sufficient credit to process this request.