Skip to main content
fastcrw
All providersProvider terms
fastCRW Pergamon
Geocoding · BR

ViaCEP

viacep.com.br

Brazilian postal code (CEP) lookup: street, neighbourhood, city, state, IBGE municipality code, area code and coordinates for a CEP, plus reverse lookup by state and city.

Showing the catalogue

1Request

Two-letter state code.

City name.

Street name, at least three characters.

1 credit⌘ ↵
Code follows the fields above
curl "https://api.fastcrw.com/v1/data/viacep/address-search?uf=SP&city=S%C3%A3o+Paulo&street=Avenida+Paulista" \
  -H "Authorization: Bearer $FASTCRW_API_KEY"

2Response example

A sample shape. Press Run to see live data from ViaCEP.

JSON
[
  {
    "cep": "01310-915",
    "logradouro": "Avenida Paulista",
    "complemento": "1294",
    "unidade": "Edifício Eluma",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01311-925",
    "logradouro": "Avenida Paulista",
    "complemento": "1415",
    "unidade": "Bradesco Seguros S/A",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01311-921",
    "logradouro": "Avenida Paulista",
    "complemento": "1159",
    "unidade": "Edifício Barão de Serro Azul",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01310-905",
    "logradouro": "Avenida Paulista",
    "complemento": "352",
    "unidade": "Edifício Louis Pasteur",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01310-908",
    "logradouro": "Avenida Paulista",
    "complemento": "750",
    "unidade": "Edifício Theobaldo de Nigris",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01310-000",
    "logradouro": "Avenida Paulista",
    "complemento": "até 610 - lado par",
    "unidade": "",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01311-920",
    "logradouro": "Avenida Paulista",
    "complemento": "1111",
    "unidade": "Citibank S.A.",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01310-914",
    "logradouro": "Avenida Paulista",
    "complemento": "1106",
    "unidade": "Edifício Elijass Gliks-Manis",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01310-941",
    "logradouro": "Avenida Paulista",
    "complemento": "1842",
    "unidade": "Caixa Econômica Federal.",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  {
    "cep": "01311-907",
    "logradouro": "Avenida Paulista",
    "complemento": "453",
    "unidade": "Edifício Olivetti",
    "bairro": "Bela Vista",
    "localidade": "São Paulo",
    "uf": "SP",
    "estado": "São Paulo",
    "regiao": "Sudeste",
    "ibge": "3550308",
    "gia": "1004",
    "ddd": "11",
    "siafi": "7107"
  },
  "… 40 more items"
]

Attribution: Source: ViaCEP (viacep.com.br). Address data originates with Correios.

Licence: ViaCEP publishes no terms of use, licence or attribution requirement on its site. The service is free and keyless but grants no rights over the address data, which originates from the Brazilian postal service (Correios). No reuse licence is stated anywhere on the service's site or API documentation. Access is offered free of charge but no grant of rights accompanies it; we therefore claim nothing: commercial use and redistribution are both recorded as false and the response is passed through unmodified and uncredited as ours.

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • CEP by address

    Use ViaCEP (viacep) from fastCRW Pergamon, capability "CEP by address" (address-search). You have a Brazilian street address and need its postal code. Example options: uf=SP, city=São Paulo, street=Avenida Paulista. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "viacep" and capability "address-search". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Address by CEP

    Use ViaCEP (viacep) from fastCRW Pergamon, capability "Address by CEP" (cep). You hold a Brazilian CEP and need the full address and municipality code. Example options: cep=01001000. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "viacep" and capability "cep". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>