---
title: "Consulta de endereço por CEP"
method: GET
path: "/addresses/{zipCode}"
tags: ["Endereços"]
---

# Consulta de endereço por CEP

`GET /addresses/{zipCode}`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/addresses/{zipCode}`
- Auth: HTTP bearer

Realize consultas de endereços através do código postal.

## Path parameters

- `zipCode` string, nullable, required: Código postal correspondente ao endereço.

## Parameters

- `#/paths/~1banklist/get/parameters/5` (unresolved $ref)
- `#/paths/~1banklist/get/parameters/6` (unresolved $ref)

## Response `200`

Recurso encontrado

- Address
  - `zipCode` string, required: Código postal correspondente ao endereço. Informe somente números.
  - `addressLine` string, required: Logradouro (nome da rua, avenida etc.).
  - `neighborhood` string, required: Nome do bairro ou distrito.
  - `city` string, required: Nome da cidade.
  - `state` string, required: Sigla do estado brasileiro, conforme a ISO 3166-2:BR. 'AC','AL','AM','AP','BA','CE','DF','ES','GO','MA','MG','MS','MT','PA','PB','PE','PI','PR','RJ','RN','RO','RR','RS','SC','SE','SP','TO'
  - `country` string, required: Sigla do país (Brasil), conforme a ISO 3166-2. Exemplo: BR.
  - `cityCode` string, required: Código do município, conforme a tabela do IBGE. Exemplo: 3550308.

## Other responses

- `400`: Há algum problema com a sua requisição.
- `404`: Recurso não encontrado.
- `500`: Ocorreu algum erro inexperado no nosso servidor.

---

[API](https://skmtc.dev/bankly/apis/servi-os-auxiliares.md) - [All operations](https://skmtc.dev/bankly/apis/servi-os-auxiliares/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/servi-os-auxiliares/revisions/7c38f7bfd212?raw)