EZCNAM API DOCUMENT

THE API CALL

The EZCNAM API call is an HTTPS query consisting of 4 simple parts:
EZCNAM HTTPS query
  • API web address - The HTTP address of our API servers.
  • Key - Your unique API key will be assigned to you when you create an EZCNAM account.
  • Phone Number - The phone number you would like to look-up.
  • Format - You can get your CNAM result in any of these formats: json, xml, text


EXAMPLES

Try these examples, but don't forget to replace the x's with your actual account key:

JSON Query: https://api.ezcnam.com/v1?key=xxxxxxx&phone=12125551234&out=json

JSON response: {"status":"OK","name":"Singh Daniel"}


XML Query: https://api.ezcnam.com/v1?key=xxxxxxx&phone=12125551234&out=xml

XML Response:
<result>
     <status>OK</status>
     <name>Singh Daniel</name>
</result>



TESTING

Since the EZCNAM API is actually just a regular URL, the easiest place to test an API call is in your web browser on your computer. Simply paste the API call into the address bar of your browser and press enter. This will allow you to view exactly what is being returned from your API call. Try it with the examples above!

CODE EXAMPLES

Here are some examples in various programming languages:

cURL:
curl "https://api.ezcnam.com/v1?key=xxxxxx&phone=2125551234&out=json"


PHP:
<?php
     $url = "https://api.ezcnam.com/v1?key=xxxxxx&phone=2125551234&out=json";
     $ret = file_get_contents($url);
     $result = json_decode($ret);
     echo $result->name;
?>


Perl:
use LWP::UserAgent;
use JSON;
$url = "https://api.ezcnam.com/v1?key=xxxxxxx&phone=2125551234&out=json";
$ua = LWP::UserAgent->new(ssl_opts => { verify_hostname => 1 });
$res = $ua->get($url);
$json = decode_json($res->decoded_content);
print $json->{'name'};

Note: Socket_SSL and JSON libraries must be installed. CentOS Linux example:
yum install -y perl-IO-Socket-SSL perl-JSON.noarch


Python:
import json
import urllib2
url = "https://api.ezcnam.com/v1?key=xxxxxx&phone=2125551234&out=json"
res = json.load(urllib2.urlopen(url))
print res['name']