CEP Lookup (Brazilian ZIP)

What Is a CEP Lookup?

CEP Lookup finds the full address behind any Brazilian postal code (CEP) in seconds. Enter the 8-digit CEP and the tool queries the free, public ViaCEP service to return the street, district, city, state and area code (DDD), then lets you copy a ready-to-use formatted address with one click. Your recent lookups are kept in the browser session so you can revisit them quickly. It is perfect for filling out forms, validating shipping addresses, or building and testing address features — and only the CEP you type is ever sent to the lookup service.

CEP (Código de Endereçamento Postal) is the Brazilian postal code system — an 8-digit code that identifies a specific street, neighbourhood, city and state in Brazil. Looking up a CEP returns the full address associated with it, which is useful for auto-filling forms, validating delivery addresses, and building logistics applications. Every Brazilian address has a unique CEP.

How to Use CEP Lookup

  1. Type an 8-digit CEP (for example 01001-000) and press Search or Enter.
  2. Read the street, district, city, state and DDD returned for that code.
  3. Copy the formatted address, or pick a previous CEP from your recent searches.

Use Cases

  • Auto-filling an address form in a Brazilian e-commerce or delivery application when the user types their CEP.
  • Validating that a postal code entered by a user corresponds to a real Brazilian address.
  • Looking up the city and state associated with a CEP for geographic filtering or analytics.
  • Developers testing address form auto-fill logic with real CEP data.

How CEP Lookup Works

The tool queries the ViaCEP API (viacep.com.br) — a free, public, officially maintained Brazilian postal code service — with the 8-digit CEP you enter. The API returns a JSON object containing the street (logradouro), neighbourhood (bairro), city (localidade) and state (uf).

The lookup is the only feature on the site that makes a server-side request — it queries the external ViaCEP API, not our servers. The API call is made directly from your browser to ViaCEP using the browser's native fetch API. We do not log or store the CEP you look up.

Benefits and Use Cases

  • Auto-fill or verify Brazilian addresses quickly for forms and checkouts.
  • Great for developers testing address lookups against real postal data.
  • Only the CEP is sent to the public ViaCEP API; nothing else leaves your browser.

Privacy

The CEP you look up is sent directly from your browser to the ViaCEP public API. We do not receive, log or store it. The lookup result is displayed only in your browser.

FAQ

Where does the address data come from?

From the free public ViaCEP API maintained for Brazilian postal codes. Only the CEP you type is sent to it.

Why did my CEP return nothing?

The CEP may not exist or may not be registered yet. Double-check the 8 digits.

Is my search history stored?

Recent lookups are kept only in your browser session (sessionStorage) and are cleared when you close the tab.

What if a CEP is not found?

Some newer streets or developments may not yet be indexed in the ViaCEP database. You can also try the official Correios website for the most up-to-date postal code directory. CEPs with fewer than 8 digits are invalid — the format is always NNNNN-NNN (8 numeric digits, hyphen optional).