GET /cep-lookup/:cep

Endpoint

GET https://api.bunny.build/api/v1/cep-lookup/:cep

Authentication

Header	Required	Value
`X-API-Key`	Yes	Your API key (`bun_...`)

Overview

Resolve any Brazilian postal code (CEP) to a full address instantly. Bunny’s CEP API returns street name, neighborhood, city, and state for any valid 8-digit CEP, with no formatting required.

Use cases

Auto-fill address forms on checkout
Validate shipping destinations
Enrich customer records with location data
Build delivery area maps

Details

Strip hyphens before passing the CEP. Accepts 01310100 or 01310-100. Both work. Returns null fields for CEPs that cover an entire municipality with no specific street.

Path parameters

Parameter	Type	Required	Description
`cep`	string	Yes	Brazilian postal code (CEP), digits only (e.g. `01310100`)

Response

200 OK

Field	Type	Description
`cep`	string	The CEP that was looked up (digits only)
`logradouro`	string	Street name
`complemento`	string	Address complement (may be empty)
`bairro`	string	Neighborhood
`cidade`	string	City name
`uf`	string	State abbreviation (e.g. `SP`)
`estado`	string	Full state name (e.g. `São Paulo`)
`regiao`	string	Brazilian region (e.g. `Sudeste`, `Nordeste`)

Example

{
  "cep": "01310100",
  "logradouro": "Avenida Paulista",
  "complemento": "de 1 a 610 - lado par",
  "bairro": "Bela Vista",
  "cidade": "São Paulo",
  "uf": "SP",
  "estado": "São Paulo",
  "regiao": "Sudeste"
}

401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

404 Not Found

CEP not found.

{
  "detail": "CEP not found"
}

422 Unprocessable Entity

Invalid CEP format.

{
  "detail": "Invalid CEP format"
}

429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

cURL example

curl https://api.bunny.build/api/v1/cep-lookup/01310100 \
  -H "X-API-Key: bun_your_api_key"

Introduction

API Reference

GET /cep-lookup/:cep

Endpoint

Authentication

Overview

Use cases

Details

Path parameters

Response

200 OK

401 Unauthorized

402 Payment Required

404 Not Found

422 Unprocessable Entity

429 Too Many Requests

cURL example

​Endpoint

​Authentication

​Overview

​Use cases

​Details

​Path parameters

​Response

​200 OK

​401 Unauthorized

​402 Payment Required

​404 Not Found

​422 Unprocessable Entity

​429 Too Many Requests

​cURL example

Endpoint

Authentication

Overview

Use cases

Details

Path parameters

Response

200 OK

401 Unauthorized

402 Payment Required

404 Not Found

422 Unprocessable Entity

429 Too Many Requests

cURL example