# Postal/ZIP Codes by City Lookup

> Postal/ZIP Codes by City Lookup is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns all postal/ZIP codes covering a specified city given country, state, and city name parameters.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/postal-by-city
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/postal-zip-codes-by-city-lookup-fd263d68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f92F_7EnwxNPxqFiUd2Z5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability postal-zip-codes-by-city-lookup-fd263d68 -d '<json body>'
```

Example prompt: What are all the ZIP codes that cover Beverly Hills, CA in the US?

## When to prefer this

Use this endpoint when you need to enumerate all ZIP/postal codes associated with a specific named city, especially for the US market. Prefer this over reverse-geocoding endpoints when the input is a city name rather than coordinates, and when you need the full set of codes rather than a single point lookup.

## Known failure modes

- City name not found or misspelled — returns empty result or error
- Invalid or unsupported country code — may return error or no results
- State abbreviation mismatch — wrong state code causes no match
- Missing required parameters (country, state, or city) — returns 400 or error JSON
- City spans ambiguous boundaries — may return incomplete set of ZIP codes
- Payment not processed (x402) — returns 402 Payment Required

## How this service works

GEO: find the postal/ZIP codes covering a city (?country=us&state=CA&city=Beverly Hills). Returns JSON.

## Output

A JSON array or object listing all postal/ZIP codes that geographically cover the specified city, including relevant coverage metadata for each code.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/postal-zip-codes-by-city-lookup-fd263d68/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)