# Suverse Postal US ZIP Lookup

> Suverse Postal US ZIP Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Resolves a 5-digit US ZIP code to its city name, state abbreviation, latitude, and longitude using the Zippopotam.us postal database.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-postal-us-zip
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-postal-us-zip-lookup-9cb5e034
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UvOsUImFPKIqIff2PGpAi

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 suverse-postal-us-zip-lookup-9cb5e034 -d '<json body>'
```

Example prompt: What city, state, and coordinates does ZIP code 90210 correspond to?

## When to prefer this

Choose this endpoint when you need a quick, cheap ZIP-to-location resolution for US postal codes without an API key, especially in agent workflows where you need to enrich address data with city, state, or coordinates. Prefer this over full geocoding APIs when you only have a ZIP code and need basic geospatial context rather than full address parsing.

## Known failure modes

- Invalid or non-existent ZIP code returns an error or empty result
- Non-US postal codes are not supported
- Malformed input (e.g. 4-digit or alphanumeric codes) will fail validation
- Zippopotam.us database may lag on newly created ZIP codes

## How this service works

Resolve any US ZIP code to its place name, state, and geographic coordinates. Backed by the free Zippopotam.us postal database. Pass a 5-digit ZIP and get back city, state abbreviation, latitude, and longitude.

## Output

Returns the place name (city), state abbreviation, latitude, and longitude corresponding to the submitted 5-digit US ZIP code, sourced from the Zippopotam.us postal database.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-postal-us-zip-lookup-9cb5e034/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)