---
title: "Listar contas bancárias"
method: GET
path: "/{alias}/checkout/sellers/bank-accounts"
tags: ["Checkout - Contas bancárias"]
---

# Listar contas bancárias

`GET /{alias}/checkout/sellers/bank-accounts`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts`
- Auth: API key in header `User-Token` and API key in header `User-Secret-Key`

Lista todas as contas bancárias associadas aos vendedores

## Path parameters

- `alias` string, required

## Response `200`

Lista de contas bancárias

- object: Representa uma paginação com meta
  - `data` SellerBankAccount[]: Contas bancárias cadastradas para o vendedor.
    - `id` integer: Identificador único da conta bancária.
    - `affiliation_id` integer: ID da afiliação de pagamento em que a conta foi cadastrada.
    - `bank_code` string, required: Código do banco, conforme a lista em `GET {alias}/checkout/banks`.
    - `external_gateway_id` integer, required: ID da conta bancária no gateway de pagamento.
    - `agency` string, required: Número da agência bancária, sem o dígito verificador.
    - `agency_digit` string, required: Dígito verificador da agência.
    - `account` string, required: Número da conta bancária, sem o dígito verificador.
    - `account_digit` string, required: Dígito verificador da conta.
    - `document_number` string, required: CPF ou CNPJ do titular da conta.
    - `legal_name` string, required: Nome ou razão social do titular da conta.
    - `type` string, required: Tipo da conta (`conta_corrente`, `conta_poupanca`, `conta_corrente_conjunta` ou `conta_poupanca_conjunta`).
  - `meta` object: Metadados da resposta.
    - `pagination` object: Dados de paginação do resultado.
      - `total` integer: Quantidade total de registros encontrados, considerando todas as páginas.
      - `count` integer: Quantidade de registros retornados na página atual.
      - `per_page` integer: Quantidade máxima de registros por página.
      - `current_page` integer: Número da página atual.
      - `total_pages` integer: Quantidade total de páginas do resultado.
      - `links` object: Links de navegação entre as páginas do resultado.
        - `previous` string: URL da página anterior, ausente quando a página atual é a primeira.
        - `next` string: URL da próxima página, ausente quando a página atual é a última.

## Other responses

- `400`: Requisição inválida
- `404`: Nenhuma conta bancária encontrada

## Changes

- **2026-11-03** `bbafb577e11c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yampi/apis/yampi-api/changes/:alias/checkout/sellers/bank-accounts/get.md)

---

[API](https://skmtc.dev/yampi/apis/yampi-api.md) - [All operations](https://skmtc.dev/yampi/apis/yampi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yampi/apis/yampi-api/revisions/74739ec8876f?raw)
