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

# Smarty US Autocomplete Pro API

The US Autocomplete Pro API provides real-time address suggestions as users type, helping to reduce errors and improve data quality. It offers autocomplete functionality for US addresses with intelligent matching and validation. The API exposes 1 endpoints secured with apiKey authentication.

## For AI agents

Programmatically autocomplete address. Covers 1 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for data enrichment only.

## Capabilities

- Autocomplete address
- Manage data enrichment data programmatically
- Integrate US Autocomplete Pro API into automated workflows
- Query and filter US Autocomplete Pro API records by parameters
- Monitor US Autocomplete Pro API operational status and events

## Use cases

### Data Enrichment Operations

Use the US Autocomplete Pro API to perform data enrichment operations programmatically. The API provides 1 endpoints covering core functionality including autocomplete address.

Example prompt: Call GET /lookup to autocomplete address

### AI Agent Integration via Jentic

AI agents discover and call US Autocomplete Pro 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 'autocomplete address', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /lookup | Autocomplete address |

## Key resources

- **Autocomplete** — Address autocomplete operations

## Why Jentic

- **Setup:** Wiring the US Autocomplete Pro API by hand means passing its auth-id key on the query string against us-autocomplete-pro.api.smarty.com and managing retries yourself. Through Jentic you install once, import the US Autocomplete Pro API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** US Autocomplete Pro exposes a single lookup operation with its input in the query string rather than a path-scoped resource, so scope the agent to just that lookup operation. You choose which operations are allowed, so nothing beyond address autocomplete runs unless you add it.
- **Credential handling:** Your Smarty key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'autocomplete a US address', and Jentic returns the matching US Autocomplete Pro operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Clearbit** — Alternative data enrichment API
- **Fullcontact** — Alternative data enrichment API
- **Hunter** — Complementary data enrichment API

## FAQ

### What authentication does the US Autocomplete Pro API use?

The US Autocomplete Pro 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 autocomplete address with the US Autocomplete Pro API?

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

### What are the rate limits for the US Autocomplete Pro 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 autocomplete address through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'autocomplete address'. Jentic returns the matching US Autocomplete Pro API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the US Autocomplete Pro API have?

The US Autocomplete Pro API exposes 1 endpoints covering autocomplete operations.

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

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent can use. The US Autocomplete Pro API exposes a single lookup operation (GET /lookup), so you scope the agent to just that address autocomplete call and nothing else runs unless you add it. Your Smarty auth-id key is stored by your instance and injected only when that allowed operation executes.