---
title: "Listagem de instituições financeiras"
method: GET
path: "/banklist"
tags: ["Instituições Financeiras"]
---

# Listagem de instituições financeiras

`GET /banklist`

## Request

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

<div class="bkly-ref-description">
  <p>Obtenha uma lista de instituições financeiras e suas informações, como o ISPB, os produtos ofertados, o tipo de banco (se é folha, destino ou ambos), dentre outras.</p>
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: banklist.read</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Caso não seja enviado um valor no campo <code>product</code>, será assumido o valor padrão <b>TED</b>. Confira a documentação [Listagem de instituições financeiras](/docs/listagem-bancos) para mais informações."
}
[/block]

## Query parameters

- `name` string, nullable: Nome do banco que deseja consultar.
- `product` 'TED' | 'PIX' | 'accountPortability': Nome do produto.
- `id` string[], nullable: Código do banco. Este campo aceita mais de um valor, o qual resulta em múltiplas consultas. Ex.: id=332&id=223.
- `page` string, nullable: Página que deseja consultar.
- `pageSize` string: Quantidade de bancos a serem exibidos por página.

## Headers

- `api-version` string, required
- `Authorization` string, required: <i>Token</i> de autorização do tipo Bearer.

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