# Suverse ZIP Code Lookup

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

Resolves a postal code to place names, city, state, latitude, and longitude via Zippopotam, requiring no API key.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-zip-lookup
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-zip-code-lookup-94fbef28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UdfGXN4LOa24yrF9Sz7ZN

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-zip-code-lookup-94fbef28 -d '<json body>'
```

Example prompt: Can you look up ZIP code 90210 and tell me the city, state, and coordinates it maps to?

## When to prefer this

Choose this endpoint when you need to resolve a US postal code to city, state, and coordinates without managing an API key. It is ideal for lightweight address enrichment and validation in agentic workflows where simplicity and low cost ($0.002/call) matter more than bulk geocoding or full address parsing. Prefer alternatives if you need full street-level geocoding, international postal code coverage, or batch processing at scale.

## Known failure modes

- Invalid or non-existent ZIP code returns empty places array or error
- Malformed request body causes a 400 Bad Request
- Payment failure via x402 protocol prevents processing
- Non-US postal codes may return no results or partial data
- Network timeout if the upstream Zippopotam service is unavailable

## How this service works

Resolve a postal code to its place names, state, and coordinates via Zippopotam, no key. Returns places with city, state, latitude, and longitude. For AI agents validating addresses and enriching postal codes.

## Output

Returns a JSON object containing an array of places for the given postal code, each with city name, state name, state abbreviation, latitude, and longitude. Also includes the country code and the postal code itself.

## 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-zip-code-lookup-94fbef28/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)