Overview

The area code API is designed for developers with experience programming. If you are looking for a copy and paste solution, try our area code widgets. The API provides output in either JSON or XML format. An API key is not required, but we require that you provide certain parameters that will allow us to track API usage. API rate limits are currently unpublished. The following data is provided by the API.

• Area code timezone
• Current time in the timezone
• Area code state

API URL

GET Parameters

Terms of Use

The API is provided as-is. AllAreaCodes.com takes no liability for the use of this data. You may not cache, store, or sub-license the data, and AllAreaCodes.com reserves the right to discontinue the API at any time.

We require that every web page that displays the data from the API display the following link back to AllAreaCodes.com. The tracking_url parameter should be set to the page in which the API results are being displayed and the link below is displayed.

Sample JSON Response

{
	status: "success",
	error_message: "",
	area_codes: [
		{
			area_code: "601",
			state: "MS",
			timezone: "Central",
			current_time: "11:38am"
		}
	]
}

PHP Example

<?php
function getAreaCodeInfo($npa) {
	$q = http_build_query(array(
		"npa" => $npa, 
		"tracking_email" => $_SERVER[SERVER_ADMIN], 
		"tracking_url" => "http://$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]"
		));
	$contents = file_get_contents("http://www.allareacodes.com/api/1.0/api.json?$q");
	$json = json_decode($contents, true);
	return $json;
}

$data = getAreaCodeInfo(601);
print "Area code 601 is located in " . $data[area_codes][0]["state"] . ".\n\n";
print "Timezone: " . $data[area_codes][0]["timezone"] . "\n\n";
print "Current time: " . $data[area_codes][0]["current_time"];
?>

Example Output

Area code 601 is located in MS.

Timezone: Central

Current time: 1:26am

More Information

Area Codes by Number

U.S. Area Code List
by State with Cities

Canadian
Area Code Listings

Other US Area Codes

Other