---
title: "Listar bancos"
method: GET
path: "/api/v1/banks"
tags: ["Bancos"]
---

# Listar bancos

`GET /api/v1/banks`

## Query parameters

- `name` string
- `onlyAsaas` boolean
- `page` integer
- `size` integer

## Response `200`

OK

- PageBankOutputDto
  - `totalElements` integer
  - `totalPages` integer
  - `last` boolean
  - `pageable` PageableObject
    - `paged` boolean
    - `unpaged` boolean
    - `pageSize` integer
    - `pageNumber` integer
    - `offset` integer
    - `sort` SortObject[]
      - `direction` string
      - `nullHandling` string
      - `ascending` boolean
      - `property` string
      - `ignoreCase` boolean
  - `numberOfElements` integer
  - `first` boolean
  - `size` integer
  - `content` BankOutputDto[]
    - `id` integer, required — Identificador único do banco no Base.
    - `name` string, required — Nome do banco.
    - `code` string — Código banco (BACEN).
    - `agency` string — Número da angencia.
    - `account` string — Número da conta.
    - `balance` number, required — public.api.bank.balance
  - `number` integer
  - `sort` SortObject[]
    - `direction` string
    - `nullHandling` string
    - `ascending` boolean
    - `property` string
    - `ignoreCase` boolean
  - `empty` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/baseerp/apis/api-base-by-asaas.md) · [All operations](https://skmtc.dev/baseerp/apis/api-base-by-asaas/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baseerp/api-base-by-asaas/revisions/408ce44b0d29/schema)