# Zip Code Data API API

> Zip Code Data API API on Apizie: 7 endpoints (Validate License Key, Distance Between 2 Zip Codes, List All MSA Groups, Metro/Micro Statistical Area Details, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/places:metadapi/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `places:metadapi`
- Category: Places
- Status: byok
- Source: https://metadapi.com/support
- Page: https://apizie.tech/api/places/metadapi
- OpenAPI: https://apizie.tech/api/places/metadapi/openapi.json

The Zip Code API provides United States zip code data with a comprehensive data model in JSON format. Using REST design, this API can help you build zip validations, city searches, distance calculations, radius…

## Endpoints

### Validate License Key
`GET https://apizie.tech/v1/places:metadapi/get-zipc-v1` (byok)

### Distance Between 2 Zip Codes
`GET https://apizie.tech/v1/places:metadapi/get-distance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| zipCode1 | string | yes | Zip Code 1 |
| zipCode2 | string | yes | Zip Code 2 |

### List All MSA Groups
`GET https://apizie.tech/v1/places:metadapi/get-msagroups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | yes | Number of records to return in each page. Max value: 50. |
| offset | integer | yes | Offset is the position in the dataset to start retrieval of records. |
| stateCode | string | no | Parameter for state code. |

### Metro/Micro Statistical Area Details
`GET https://apizie.tech/v1/places:metadapi/get-msagroups-msacode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| msaCode | string | yes | 5 digit MSA (Metropolitan Statistical Area) code. |

### Zip Code Radius
`GET https://apizie.tech/v1/places:metadapi/get-radius` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| zipCode | string | yes | 5 Digit US Zip Code |
| radius | integer | yes | Radius distance. Max 322 km or 200 mi |
| uom | string | yes | Unit of Measure |

### List all Zip Codes
`GET https://apizie.tech/v1/places:metadapi/get-zipcodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| offset | number | no | Offset is the position in the dataset to start retrieval of records. |
| limit | number | no | Number of records to return in each page. |
| zipcode | string | no | 5 Digit Zip Code query parameter. Can have multiple values (separated by comma). |
| uspsMainCityKey | string | no | Parameter for USPS City / Town key identifier for the main city of the zip code. |
| zipClassificationCode | string | no | Parameter for zipClassificationCode |
| uspsFacilityCode | string | no | Parameter for facility code. |
| uspsDeliveryCode | string | no | Parameter for delivery code. |
| uspsCarrierRouteSortCode | string | no | Parameter for carrier route sort code. |
| uniqueZipNameInd | boolean | no | Parameter for unique zip name indicator. |
| uspsFinanceNumber | string | no | Parameter for finance number. |
| stateCode | string | no | Parameter for state code. |
| stateFipsCode | string | no | Parameter for State FIPS code. |
| countyFipsCode | string | no | Parameter for county FIPS code. |
| divisionCode | string | no | Parameter for division code. |
| regionCode | string | no | Parameter for region code. |
| msaCode | string | no | Parameter for msaCode. |

### Zip Code Details
`GET https://apizie.tech/v1/places:metadapi/get-zipcode` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| zipcode | string | yes | 5 Digit US Zip Code |

## Example
```
curl "https://apizie.tech/v1/places:metadapi/get-zipc-v1" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Zip Code Data API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/places:metadapi/get-zipc-v1 with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Zip Code Data API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Zip Code Data API itself also needs your own key from metadapi.com.

### Can AI agents use the Zip Code Data API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key places:metadapi.

### What is the status of the Zip Code Data API API?
Needs your own provider key (bring your own key)