canonical: https://jentic.com/apis/interzoid.com/interzoid-get-area-code-api

# Interzoid Get Area Code API

The Interzoid Get Area Code API returns the geographic location associated with a North American telephone area code, including the city, state or province, and country. Agents pass a three-digit area code as a query parameter and receive structured location metadata for routing, lead enrichment, or call analytics workflows. The single GET /getareacode endpoint authenticates with a license key passed as a query parameter and returns JSON.

## For AI agents

Look up the city, state, and country for a North American telephone area code. One GET endpoint, license-key auth.

## Scope

Does not validate phone numbers, identify carriers, or handle international dialing codes outside North America - use for North American area code geography only.

## Capabilities

- Resolve a three-digit area code into city, state, and country fields
- Enrich CRM lead records with geographic context derived from a phone number prefix
- Validate that a captured area code corresponds to a real North American region
- Route inbound call records to the correct sales territory based on area code geography
- Append location metadata to call detail records for analytics and reporting

## Use cases

### CRM lead geography enrichment

When a lead enters a CRM with only a phone number, the Interzoid Get Area Code API resolves the leading three digits into the corresponding city, state, and country. This lets sales operations assign territory ownership and tailor outreach without requiring the lead to enter their address. The endpoint accepts a single area code per call and responds in under a second, suitable for synchronous form-submission flows.

Example prompt: Call /getareacode with areacode=415 and write the returned City and State values onto the lead record.

### Call routing by area code

Inbound call platforms use the Interzoid Get Area Code API to map the caller's area code to a region and route the call to the regional sales or support queue. The lookup returns city, state, and country fields that map cleanly to existing territory definitions, removing the need to maintain an internal area-code-to-region table.

Example prompt: For inbound caller area code 312, fetch /getareacode and route to the queue assigned to State=Illinois.

### Phone number data validation

Data quality teams use the API to flag records where the captured area code does not correspond to any real North American region. Records returning an error or empty location are queued for manual review or re-collection, improving downstream call-completion rates.

Example prompt: Iterate the contacts table, call /getareacode for each unique 3-digit prefix, and tag rows where the response is empty or returns an error code.

### AI agent geographic phone enrichment

An AI agent handling customer phone records discovers the Interzoid Get Area Code API through Jentic's intent search, loads the schema, and resolves area codes inline during conversational data-cleanup tasks. Jentic stores the Interzoid license key in the credential vault and injects it as the license query parameter at execution time, so the agent never sees the raw key.

Example prompt: Search Jentic for 'look up city from phone area code', load the Interzoid Get Area Code operation, and execute it for area code 617.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/getareacode` | Return city, state, and country for a North American area code |

## Key resources

- **Area code lookup** — Single GET operation that accepts a three-digit area code and returns the associated city, state, and country.

## Why Jentic

- **Setup:** Wiring the Interzoid Get Area Code API by hand means passing your licence key as a query parameter on every call and remembering the single /getareacode endpoint. Through Jentic you install once, import the Interzoid Get Area Code API from the API Directory, store the licence key once, and your agent calls it.
- **Permission scoping:** This API exposes one read-only operation, GET /getareacode, with the area code in the query, so limit the agent to that operation. It performs no writes or deletes, so there is nothing destructive to add.
- **Credential handling:** Your Interzoid licence key is stored once, encrypted, by your own Jentic One instance and injected as the license query parameter at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'look up the city for an area code', and Jentic returns the GET /getareacode operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Interzoid Get Area Code From Number API** — Same geographic lookup but accepts a full phone number instead of a pre-extracted area code
- **Interzoid Get Global Phone Number Information API** — Returns broader phone number metadata for international numbers, not just North American area codes
- **Interzoid Zip Code Detailed Info API** — Provides detailed location info for US zip codes, useful alongside area code geography for full address enrichment

## FAQ

### What authentication does the Interzoid Get Area Code API use?

The API uses a license key passed as the license query parameter on every request to /getareacode. Through Jentic, the license key is held in the credential vault and injected at execution time so the agent never handles the raw key.

### Can I look up Canadian area codes with the Interzoid Get Area Code API?

Yes. The /getareacode endpoint covers North American Numbering Plan codes, which include Canada and the United States, and the response includes the country field so you can distinguish between them.

### What are the rate limits for the Interzoid Get Area Code API?

The OpenAPI spec does not publish a numeric rate limit. Interzoid enforces limits per license tier on the account dashboard, so check the account page for your specific quota before running large batch jobs.

### How do I look up an area code through Jentic?

Install the Python SDK with pip install jentic, then search for 'look up city from phone area code', load the Interzoid Get Area Code operation, and execute it with areacode set to the three-digit code you want to resolve.

### Does the Interzoid Get Area Code API accept full phone numbers?

No. This endpoint accepts only the three-digit area code. To start from a full phone number, use the Interzoid Get Area Code From Number API instead, which extracts the area code internally.

### Can I limit what my agent is allowed to do with the Interzoid Get Area Code API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use, and this API exposes only one read-only operation, GET /getareacode, so you can restrict the agent to that single lookup. There are no write or delete operations to permit, so the agent can resolve an area code to city, state, and country but cannot change anything. Your Interzoid license key stays under your control and is injected as the license query parameter at execution time, so the agent never handles the raw key.