{"uid":"cap_YHAZK0YzG80b11196zNtX","slug":"pontofato-cep-address-lookup-40564aa6","name":"PontoFato CEP Address Lookup","description":"Address lookup for CEP 01310100: the addresses and the companies registered there. One payment for this call.","url":"https://pontofato.com/api/x402/cep/:cep?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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_edificacao":{"type":"string"}}},"description":"Até 20 endereços do CEP, com logradouro, número, bairro, cidade, UF, coordenada e espécie."},"consulta":{"type":"string","description":"Sempre `cep`."},"empresas":{"type":"object","properties":{"mais":{"type":"boolean","description":"`true` quando o CEP tem mais empresas que as devolvidas."},"itens":{"type":"array","items":{"type":"object","properties":{"uf":{"type":"string"},"cnae":{"type":"object","properties":{"codigo":{"type":"number"},"descricao":{"type":"string"}}},"cnpj":{"type":"string"},"bairro":{"type":"string"},"situacao":{"type":"object","properties":{"label":{"type":"string"},"codigo":{"type":"number"}}},"municipio":{"type":"string"},"razaoSocial":{"type":"string"},"nomeFantasia":{"type":"string"},"cnpjFormatted":{"type":"string"},"situacaoEspecial":{"type":"null"}}},"description":"Até 20 cards: `cnpj`, `cnpjFormatted`, `razaoSocial`, `nomeFantasia`, `situacao`, `bairro` e `cnae`."}},"description":"`null` quando a base de empresas não respondeu."},"endereco":{"type":"object","properties":{"uf":{"type":"string"},"lat":{"type":"number"},"lon":{"type":"number"},"ibge":{"type":"string"},"bairro":{"type":"string"},"cidade":{"type":"string"},"edificios":{"type":"number"},"address_count":{"type":"number"}},"description":"Resumo do CEP: unidades, edifícios, bairro, cidade, UF, código IBGE, centro (lat/lon) e espécies."},"pontos_total":{"type":"number","description":"Quantos endereços a origem devolveu para o CEP."}},"description":"Os endereços de um CEP e as empresas registradas nele."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_atfwFroyJ7EwTC3l2jFkG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Validate delivery address by CEP","prompt":"I have a customer order with CEP 01310-100 — can you pull up the address details for that postal code so I can confirm the street and neighborhood are correct?"},{"title":"Find businesses at a postal code","prompt":"What companies are registered at CEP 04538-133 in São Paulo? I want to see their names and how many there are."},{"title":"Geocode a CEP for mapping","prompt":"I need the latitude and longitude for CEP 20040-020 in Rio de Janeiro — can you look it up and give me the coordinates along with the street name and city?"}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:32:52.476Z","isFirstParty":false,"canonicalSlug":"pontofato-cep-address-lookup-40564aa6"}