{"uid":"cap_W5A6W1Tk4SN6Rw9CZErpm","slug":"brdata-brazilian-cep-postal-code-lookup-f5a9b046","name":"brdata — Brazilian CEP (Postal Code) Lookup","description":"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).","url":"https://brdata.thomenz.me/cep/%7Bcep%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Mv7-IzGNjn8MJsNSaMS9N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Brazilian postal code (CEP) to a full address with coordinates, IBGE city code, neighborhood, city, and state","exampleAgentPrompt":"Can you look up the address details for CEP 01310-930 in Brazil — I need the street name, neighborhood, city, state, and coordinates?","exampleUseCases":[{"title":"Auto-fill address form from CEP","prompt":"The user typed in CEP 04538-133 on our checkout form — can you resolve that to a full Brazilian address with street, neighborhood, city, state, and IBGE code so I can pre-fill the fields?"},{"title":"Geocode a Brazilian delivery location","prompt":"I have a delivery going to CEP 30130-010 in Brazil and I need the latitude and longitude coordinates for that postal code so I can plot it on a map."},{"title":"Validate and enrich a Brazilian customer record","prompt":"We have a customer record with CEP 69900-971 — can you confirm that's a valid postal code and tell me which city, state, and neighborhood it belongs to, along with its IBGE code?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:46:50.564Z","isFirstParty":false}