# brdata — Brazilian CEP (Postal Code) Lookup

> brdata — Brazilian CEP (Postal Code) Lookup is a paid API for AI agents from brdata.thomenz.me, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Resolves a Brazilian postal code (CEP) to a full address with coordinates, IBGE city code, neighborhood, city, and state

## Facts

- Endpoint: GET https://brdata.thomenz.me/cep/%7Bcep%7D
- 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/brdata-brazilian-cep-postal-code-lookup-f5a9b046
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_W5A6W1Tk4SN6Rw9CZErpm

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 brdata-brazilian-cep-postal-code-lookup-f5a9b046
```

Example prompt: Can you look up the address details for CEP 01310-930 in Brazil — I need the street name, neighborhood, city, state, and coordinates?

## When to prefer this

Use this endpoint when you need to resolve a Brazilian postal code to a full address with coordinates and IBGE city code in a single call, especially within an agent pipeline already using the brdata platform for other Brazilian data (CNPJ, compliance, tenders). Preferred over generic geocoding APIs when English-schema output, IBGE codes, and multi-source aggregation for Brazilian addresses are required.

## Known failure modes

- Invalid or non-existent CEP returns an error or empty result
- Malformed CEP (wrong digit count or format) may cause a 400-level error
- Upstream data source (e.g. BrasilAPI) unavailability may cause degraded or no results
- CEPs for newly created postal regions may not yet be indexed
- Payment failure via x402 protocol prevents the request from completing

## How this service works

Brazilian company & public-procurement data for due-diligence, KYB & B2B agents: company profiles by CNPJ, regulatory risk & compliance screening (federal debarment, anti-corruption, leniency & forced-labor register — CEIS, CNEP, 'Lista Suja'), mass search & segmentation across ~28M active companies, and public tenders / licitações (PNCP).

## Output

Returns a JSON object containing the resolved CEP, street name, neighborhood, city, state (abbreviation and full name), IBGE city code, geographic coordinates (latitude/longitude), and metadata about which data sources were queried and when.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cep": "01310930",
  "city": "São Paulo",
  "state": "SP",
  "street": "Avenida Paulista",
  "sources": [
   {
    "ok": true,
    "name": "brasilapi",
    "fetched_at": "2026-07-02T00:00:00.000Z"
   }
  ],
  "state_name": "São Paulo",
  "coordinates": {
   "latitude": -23.561684,
   "longitude": -46.655981
  },
  "neighborhood": "Bela Vista",
  "ibge_city_code": "3550308"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brdata-brazilian-cep-postal-code-lookup-f5a9b046/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from brdata.thomenz.me](https://www.zero.xyz/host/brdata.thomenz.me/llms.txt)