# agentsvc.io Postal Code Lookup

> agentsvc.io Postal Code Lookup is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.0025/call, status unknown (last checked 2026-10-10).

Looks up geographic details (place name, state, coordinates) for a postal code or city/state combination, supporting international queries via ISO country codes.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/postal-code?utm_source=zero.xyz
- Price: $0.0025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentsvc-io-postal-code-lookup-66d54b4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vhOU0XBfDY7ey6bAQG28m

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 agentsvc-io-postal-code-lookup-66d54b4c -d '<json body>'
```

Example prompt: What's the postal code and coordinates for München, Bavaria, Germany? I need the place details including latitude and longitude.

## When to prefer this

Use this endpoint when you need lightweight, pay-per-call postal code resolution without managing API keys or subscriptions — ideal for agents enriching address data, validating postal codes, or geocoding city/state inputs internationally. Prefer this over full geocoding APIs when you only need postal-level granularity and want zero-setup USDC micropayment billing.

## Known failure modes

- Postal code not found in GeoNames database — returns found: false with empty places array
- Invalid or unsupported country code — may return not found or error
- Missing required field combination (e.g. city without state for US) — may return ambiguous or no results
- Network timeout or upstream GeoNames outage — service error response
- Malformed input (non-string types) — validation error

## How this service works

86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.

## Output

Returns a JSON object with a 'found' boolean, a 'places' array containing objects with latitude, longitude, place name, state, and state code, plus the source data attribution, country code, and the queried postal code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "city": {
   "type": "string"
  },
  "state": {
   "type": "string",
   "description": "State abbreviation, required with city"
  },
  "country": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2"
  },
  "postal_code": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "found": true,
   "places": [
    {
     "lat": 48.1345,
     "lon": 11.571,
     "place": "München",
     "state": "Bayern",
     "state_code": "BY"
    }
   ],
   "source": "zippopotam.us (GeoNames)",
   "country": "DE",
   "postal_code": "80331"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentsvc-io-postal-code-lookup-66d54b4c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)