1001Ferramentas
Tools Categories Guides FAQ
About Contact Privacy Policy Terms of Use
📮Utilities

CEP Lookup

Look up Brazilian postal codes (CEP) via ViaCEP API. Returns street, neighborhood, city, state and area code.

How does it work?

Behind the lookup is the ViaCEP API, a free public service run by an independent third party with no ties to Correios, which returns address data from an 8-digit CEP.

It's your browser talking to the API directly, with no detour through our servers. Each request takes around 200ms.

For heavier demand, a commercial service is worth a look.

Look up the address for a postal code

Building the address from the postal code saves time and cuts the typos that keep cropping up in forms and sign-ups. Here you type the Brazilian CEP and get the full address back, pulled from the public ViaCEP API base.

From the number come the matching street, neighbourhood, city and state. You can check an address, complete a registration, work out a shipping cost or just find out which street and neighbourhood a postal code belongs to, all without opening the post office site.

The search goes straight to ViaCEP in real time, from the browser. Keep it close for whenever you've got a postal code in hand and the address is missing.

Frequently asked questions

Does the postal code I type leave my browser?
Yes, it does. Hitting Search makes your browser call viacep.com.br directly, at https://viacep.com.br/ws/EIGHTDIGITS/json/. The ViaCEP service receives the queried code along with your IP address and the usual request headers, under its own privacy policy. The lookup never touches this site's servers, which neither see nor store anything, but it is worth knowing the number does leave your machine — unlike most tools here, which stay sealed inside the browser.
What information comes back from a lookup?
Five fields: street, neighbourhood, city, state and telephone area code. Address complement, IBGE municipality code, GIA and SIAFI all arrive in the ViaCEP response but never get displayed. When the code is one of the city-wide ones covering a whole municipality rather than a single street, street and neighbourhood come back empty and both render as a dash — that is expected, not a failure. The lookup runs one way only: code to address, never address to code.
I clicked Search and nothing happened. What went wrong?
Almost always missing digits. The field formats itself as you type, caps at eight digits and drops letters, and the lookup only fires once all eight digits are present — below that the button does absolutely nothing and no message appears. With eight valid digits for a code that does exist in no record, a red not-found warning shows up. If the request itself fails, whether from a dropped connection, a ViaCEP outage or a browser extension blocking it, a different warning appears asking you to check your connection. Pressing Enter in the field does the same thing as clicking the button.

Related Tools

🌐

My IP Address

Discover your public IP address in seconds. See the IPv4 address assigned by your internet service provider (ISP).
🏢

CNPJ Lookup

Look up public company data by Brazilian CNPJ via BrasilAPI. Returns legal name, status, main activity and address.
🏦

Brazilian Bank Code Lookup

Look up the COMPE/ISPB code of major Brazilian banks. Search by name or code and find the official number for TED, DOC and PIX.
🏷️

Shields.io Badge Builder

Builds a shields.io badge URL from label, message and color, ready to embed in READMEs.
✨

Destiny Number Calculator

Calculate your Destiny Number in numerology from the letters of your full name (Pythagorean method). Discover your talents, life mission and potential.
🗂️

Eisenhower Matrix Builder (4 Quadrants)

Paste one task per line as task;urgent;important with 1 or 0 flags, and read them sorted into do now, schedule, delegate and drop.