---
title: "Consulta de instituições financeiras por ISPB ou código bancário"
method: GET
path: "/banklist/{id}"
tags: ["Instituições Financeiras"]
---

# Consulta de instituições financeiras por ISPB ou código bancário

`GET /banklist/{id}`

## Request

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

Consulte informações sobre a instituição financeira através do ISPB ou código bancário.

## Path parameters

- `id` string, nullable, required: Id corresponde ao ISPB ou Code. <b>Importante</b>: o campo deve conter oito caracteres. Portanto, se o ISPB do banco contiver apenas seis dígitos, por exemplo, complete-o com zeros à esquerda. Exemplo: "00123456".

## Headers

- `api-version` string, required

## Response `200`

Recurso encontrado

- Bank
  - `name` string, nullable: Nome do banco.
  - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
  - `code` string, nullable: Código do banco. Este campo somente é retornado caso a instituição seja participante do SPB (possui TED). As instituições que participam somente do SPI (que só possuem Pix) não retornarão o campo <code>code</code> nessa pesquisa.
  - `shortName` string, nullable: Nome reduzido do banco.
  - `isSPIDirect` boolean, nullable: Indica se o banco é um participante direto do SPI (Pix).
  - `products` string[], nullable: Lista que contém os produtos suportados pelo registro da instituição financeira (TED, PIX e/ou accountPortability).
  - `accountPortabilityTypes` string[]: Lista que contém as funções do banco, referentes à portabilidade de salário ("Payroll" e/ou "Destination"). Este campo somente é retornado caso o banco possua portabilidade de salário (accountPortability) como produto.

## 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)