canonical: https://jentic.com/apis/smarty.com/smarty-us-zipcode-api

# Smarty US ZipCode API

The Smarty US ZipCode API provides detailed information about US ZIP codes including city, state, latitude, longitude, and more. It validates ZIP codes and returns associated metadata including alternate city names, county information, and timezone data. The API exposes 2 endpoints secured with apiKey authentication.

## For AI agents

Programmatically batch zip code lookup, single zip code lookup. Covers 2 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Batch ZIP code lookup
- Single ZIP code lookup
- Integrate Smarty US ZipCode API into automated workflows
- Query and filter Smarty US ZipCode API records by parameters
- Monitor Smarty US ZipCode API operational status and events

## Use cases

### Developer Tools Operations

Use the Smarty US ZipCode API to perform developer tools operations programmatically. The API provides 2 endpoints covering core functionality including batch zip code lookup, single zip code lookup.

Example prompt: Call POST /lookup to batch zip code lookup

### Data Retrieval and Monitoring

Query Smarty US ZipCode API resources on a schedule to track changes, generate alerts, or feed downstream dashboards. Agents poll relevant endpoints, compare against previous state, and trigger actions when thresholds are crossed.

Example prompt: Poll the primary Smarty US ZipCode API endpoint, compare response to last known state, and alert if changed

### AI Agent Integration via Jentic

AI agents discover and call Smarty US ZipCode API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'batch zip code lookup', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /lookup | Batch ZIP code lookup |
| GET | /lookup | Single ZIP code lookup |

## Key resources

- **ZipCode Lookup** — ZIP code lookup and validation operations

## Why Jentic

- **Setup:** Wiring the Smarty US ZipCode API by hand means passing its auth-id and auth-token keys on the query string against us-zipcode.api.smarty.com and managing retries yourself. Through Jentic you install once, import the Smarty US ZipCode API from the API Directory, store the keys once, and your agent calls it.
- **Permission scoping:** The US ZipCode API carries its lookup input in the query string or request body rather than a path-scoped resource, so scope the agent to the lookup operations it needs. You choose which operations are allowed, so only the single-item or batch lookup you grant runs.
- **Credential handling:** Your Smarty keys are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'look up a US zip code' or 'batch zip code lookup', and Jentic returns the matching Smarty US ZipCode operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the Smarty US ZipCode API use?

The Smarty US ZipCode API uses an API key passed in the `auth-id` query. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I batch zip code lookup with the Smarty US ZipCode API?

Yes. Use the POST /lookup endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Smarty US ZipCode API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I batch zip code lookup through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'batch zip code lookup'. Jentic returns the matching Smarty US ZipCode API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Smarty US ZipCode API have?

The Smarty US ZipCode API exposes 2 endpoints covering zipcode lookup operations.

### Can I limit what my agent is allowed to do with the Smarty US ZipCode API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use. The Smarty US ZipCode API carries its lookup input in the query string or request body rather than a path-scoped resource, so you grant only the lookup operations the agent needs: the single lookup on GET /lookup, the batch lookup on POST /lookup, or both. Any operation you do not grant simply cannot run.