# PontoFato CEP Address Lookup

> PontoFato CEP Address Lookup is a paid API for AI agents from pontofato.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-29).

Looks up addresses and registered companies at a given Brazilian postal code (CEP), returning up to 20 address points with coordinates and company registry data.

## Facts

- Endpoint: GET https://pontofato.com/api/x402/cep/:cep?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pontofato-cep-address-lookup-40564aa6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YHAZK0YzG80b11196zNtX

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 pontofato-cep-address-lookup-40564aa6
```

Example prompt: Can you look up all the addresses and registered businesses at CEP 01310-100 in Brazil and give me the street names, neighborhoods, coordinates, and company names?

## When to prefer this

Use this endpoint when you need to resolve a Brazilian CEP to its constituent addresses and/or registered businesses in a single call. It combines address geocoding (street, neighborhood, city, state, lat/lon) with company registry data (CNPJ, CNAE) sourced from CNEFE and Receita Federal — making it preferable over standalone geocoding or CNPJ lookup tools when both address and company data are needed for the same postal code. It charges per call via x402 at $0.001 USDC, making it cost-effective for occasional lookups.

## Known failure modes

- Invalid or non-existent CEP returns no results or an error
- CEP with fewer than 8 digits may be rejected
- Payment failure via x402 protocol causes the call not to complete
- CEP has no registered addresses or companies in the database
- Truncated company list when CEP has more companies than the 20-item limit

## How this service works

Address lookup for CEP 01310100: the addresses and the companies registered there. One payment for this call.

## Output

Returns a JSON object containing: up to 20 address points (logradouro, número, bairro, cidade, UF, lat/lon, building type and species label), a list of companies registered at the CEP (with CNPJ, CNAE, name, and whether more exist), the data source credit, CEP formatted, and payment metadata (how the call was paid, price in USD, and whether it was a repeated retry).

## 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",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cep": {
       "type": "string",
       "description": "CEP com 8 dígitos, com ou sem hífen."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "cep": {
       "type": "string",
       "description": "CEP formatado."
      },
      "uso": {
       "type": "object",
       "properties": {
        "via": {
         "type": "string",
         "description": "`gratis` (franquia do dia), `saldo` (plano ou pacote), `x402` ou `credito` (a chamada paga sozinha)."
        },
        "repetido": {
         "type": "boolean",
         "description": "Na chamada paga sozinha: `true` quando o retry não cobrou de novo."
        },
        "preco_usd": {
         "type": "string",
         "description": "Na chamada paga sozinha: o preço cobrado, em dólar."
        }
       },
       "description": "Quem pagou esta consulta."
      },
      "fonte": {
       "type": "string",
       "description": "Crédito da fonte dos endereços."
      },
      "pontos": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "uf": {
          "type": "string"
         },
         "cep": {
          "type": "string"
         },
         "lat": {
          "type": "number"
         },
         "lon": {
          "type": "number"
         },
         "bairro": {
          "type": "string"
         },
         "cidade": {
          "type": "string"
         },
         "numero": {
          "type": "string"
         },
         "unidades": {
          "type": "number"
         },
         "logradouro": {
          "type": "string"
         },
         "complemento": {
          "type": "null"
         },
         "especie_label": {
          "type": "string"
         },
         "estabelecimento": {
          "type": "string"
         },
         "tipo_edificac
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pontofato-cep-address-lookup-40564aa6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pontofato.com](https://www.zero.xyz/host/pontofato.com/llms.txt)