{"uid":"cap_EUbjAyLMk8ua5fzg2ErDF","slug":"miniframe-cep-lookup-388f38a8","name":"MiniFrame CEP Lookup","description":"Use when a Brazilian postal code needs to become a real address — filling a form, validating a delivery, completing a customer record. JSON body { cep } (8 digits). Returns street, complement, neighborhood, city and state (UF). Queries BrasilAPI first and falls back to ViaCEP automatically, so one upstream outage does not fail the task; both sources return the same normalized shape. CEP is postal/geographic data, not personal data.","url":"https://tools.miniframe.com.br/cep","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cep":{"type":"string","description":"Brazilian postal code, 8 digits (with or without dash)."}}},"responseSchema":{"type":"json","example":{"cep":"01310100","city":"São Paulo","state":"SP","source":"brasilapi","street":"Avenida Paulista","complement":"","neighborhood":"Bela Vista"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UKnKfZt1fwSpUnr4HJBsF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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, normalized address including street, complement, neighborhood, city, and state, with automatic BrasilAPI→ViaCEP fallback.","exampleAgentPrompt":"Can you look up the address for CEP 01310-100 in Brazil? I need the street, neighborhood, city, and state to fill in this delivery form.","exampleUseCases":[{"title":"Autofill shipping address from CEP","prompt":"I have a customer who just entered their Brazilian postal code 20040020 in our checkout form. Can you resolve that CEP to get their full street address, neighborhood, and city so we can autofill the rest of the form?"},{"title":"Validate delivery location and address","prompt":"We're about to ship a package to São Paulo and the only info we have is the CEP 01310-100. Can you look that up and give us the complete address including the street, neighborhood, and exact city so we can verify it's a valid delivery point?"},{"title":"Enrich customer record with address details","prompt":"I'm updating our customer database and need to fill in the address fields for several clients. One of them only has a Brazilian CEP on file: 30140071. Can you resolve that to get the full street address, neighborhood, city, and state?"}],"resultDescription":"A normalized JSON object containing the resolved address fields: street (logradouro), complement, neighborhood (bairro), city (localidade), and state abbreviation (UF). The shape is consistent regardless of which upstream provider (BrasilAPI or ViaCEP) answered the request.","failureModes":["Invalid or non-existent CEP returns an error — the postal code must be exactly 8 digits and exist in Brazilian postal records","Both upstream providers (BrasilAPI and ViaCEP) unavailable simultaneously causes a service failure","Malformed input (non-numeric characters, wrong length) results in a validation error","Some CEPs may exist but have incomplete address data (e.g. no street name for large recipient CEPs)"],"whenToPreferThis":"Use this endpoint whenever you need to resolve a Brazilian CEP to a full address and require resilience against upstream outages — the dual BrasilAPI/ViaCEP fallback means a single provider failure will not break the lookup. Prefer this over direct calls to BrasilAPI or ViaCEP when building robust automation pipelines, form autofill, delivery validation, or customer record enrichment for Brazilian addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:33:19.734Z","isFirstParty":false}