Metadapi Zip Code Data API

Name: Zip Code Data API
Brand: Zip Code Data API
Availability: InStock

✓ Official Vendor SpecData EnrichmentAddress ValidationapiKey7 EndpointsREST

For Agents

Validate US zip codes and enrich them with city, county, distance, radius, and MSA data via 7 REST endpoints.

Install Jentic One Beta

Connect the Zip Code Data API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Zip Code Data API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Zip Code Data API.

Validate a US zip code and return its city, state, and county attributes

Calculate the distance between two zip codes for shipping or service-area logic

Find every zip code within a given radius of a target zip for territory expansion

GET STARTED

Start building with Zip Code Data API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Zip Code Data API for, with concrete tasks.

★ Address Form Validation

When a user enters a US zip code on a checkout or signup form, agents call the zip code lookup to validate the entry and auto-fill the corresponding city, state, and county fields. This reduces typos at submission and speeds up form completion. The dataset is keyed by zip so the lookup is a single GET against /zipc/v1/zipcodes/{zipcode}.

GET /zipc/v1/zipcodes/{zipcode} on form submission and pre-fill the city, state, and county fields with the returned values

Service-Area and Radius Search

Local-services platforms (cleaners, contractors, dental clinics) need to surface providers within a customer's distance threshold. Use the radius endpoint to retrieve every zip code within N miles of the customer's zip, then filter the provider directory by those zips. Combine with the distance endpoint to sort results by proximity.

GET /zipc/v1/radius for the customer's zip with a 25-mile radius, then filter the provider directory by the returned zip list

Territory and MSA Analytics

Sales and marketing teams roll up performance metrics by Metropolitan or Micropolitan Statistical Area. Agents use the MSA endpoints to map each customer zip to its MSA, then aggregate metrics by MSA name. Listing all MSA groups makes it easy to seed a dashboard or pivot table with the canonical region set.

GET /zipc/v1/msagroups to seed the MSA dimension, then map each customer zip to its MSA via /zipc/v1/zipcodes/{zipcode}

AI Agent Integration via Jentic

An AI agent uses Jentic to discover the Zip Code Data API by intent search ('look up a US zip code'). Jentic returns the matching operation with its input schema, so the agent enriches an address record in a single load-and-execute step. The Metadapi subscription key lives in the Jentic vault and never enters the agent's prompt.

Use Jentic to search 'look up a US zip code', load the zipcodes schema, and execute it to enrich an inbound order record

Key Endpoints

7 endpoints — the metadapi zip code data api provides a comprehensive united states zip code dataset in json over a rest surface.

METHOD

PATH

DESCRIPTION

GET

/zipc/v1/zipcodes/{zipcode}

Get details for a single zip code

GET

/zipc/v1/zipcodes

List zip codes

GET

/zipc/v1/distance

Distance between two zip codes

GET

/zipc/v1/radius

Find zip codes within a radius

GET

/zipc/v1/msagroups

List MSA groups

GET

/zipc/v1/msagroups/{msaCode}

Get MSA group details

GET

/zipc/v1

Validate API license key

GET

/zipc/v1/zipcodes/{zipcode}

Get details for a single zip code

GET

/zipc/v1/zipcodes

List zip codes

GET

/zipc/v1/distance

Distance between two zip codes

GET

/zipc/v1/radius

Find zip codes within a radius

GET

/zipc/v1/msagroups

List MSA groups

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Metadapi subscription keys are stored encrypted in the Jentic vault (MAXsystem) and injected into the `Ocp-Apim-Subscription-Key` header at request time. The raw key never enters the agent's prompt.

Intent-based discovery

Agents search by intent (e.g. 'look up a US zip code') and Jentic returns the matching operation with its schema, so the agent skips reading Metadapi's docs.

Time to first call

Direct integration: half a day for auth, error handling, and pagination of MSA endpoints. Through Jentic: under 15 minutes — search, load schema, execute.

FAQs

Specific to using Zip Code Data API through Jentic.

What authentication does the Metadapi Zip Code Data API use?

An API subscription key in the `Ocp-Apim-Subscription-Key` header, issued from your Metadapi subscription. Through Jentic the key is stored in the MAXsystem vault and injected at request time, so it never enters the agent's prompt.

Can I look up city and county data for a zip code?

Yes. GET /zipc/v1/zipcodes/{zipcode} returns the metadata associated with a specific zip, and GET /zipc/v1/zipcodes lists the dataset for bulk enumeration.

How do I calculate the distance between two zip codes?

Call GET /zipc/v1/distance with the two zip codes as parameters. The response returns the computed mile distance.

Does the API support radius searches around a zip?

Yes. GET /zipc/v1/radius returns every zip code within a given distance of a target zip, suitable for service-area or store-locator features.

How do I look up a US zip through Jentic?

Search Jentic for `look up a US zip code`, load the GET /zipc/v1/zipcodes/{zipcode} operation, and execute it with the zip. Jentic returns the structured response with city, state, and county fields.

Are there published rate limits?

The OpenAPI spec does not declare quantitative rate limits. Limits are tied to your Metadapi subscription tier — check the dashboard or contact Metadapi support before bulk traffic.