---
title: "Listar subcontas"
method: GET
path: "/sub-accounts/list"
---

# Listar subcontas

`GET /sub-accounts/list`

## Request

- Base URL: `https://api.abacatepay.com/v2`
- URL: `https://api.abacatepay.com/v2/sub-accounts/list`
- Auth: HTTP bearer

Lista as subcontas da loja, das mais recentes para as mais antigas, com o saldo de cada uma.

## Query parameters

- `after` string
- `before` string
- `limit` integer
- `startDate` string, date
- `endDate` string, date
- `taxId` string
- `externalId` string

## Response `200`

Lista de subcontas.

- object
  - `data` SubAccount[]
    - `id` string: ID único da subconta.
    - `name` string: Nome do titular.
    - `taxId` string: CPF ou CNPJ do titular, só dígitos.
    - `externalId` string, nullable: Identificador no seu sistema.
    - `balance` object: Saldo da subconta em centavos.
      - `available` integer: Disponível para saque.
      - `blocked` integer: Retido.
    - `devMode` boolean: Indica se a subconta foi criada em ambiente de testes.
    - `metadata` object
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `success` boolean: Se a requisição obteve sucesso ou não.
  - `error` string, nullable
  - `pagination` PaginationCursor: Informações de paginação baseada em cursor.
    - `hasMore` boolean, required: Indica se existe uma próxima página.
    - `next` string, nullable, required: Cursor da próxima página (usar em `after`). `null` na última página.
    - `before` string, nullable, required: Cursor da página anterior (usar em `before`). `null` na primeira página.

## Other responses

- `401`: Não autorizado. Falha na autenticação.

## Changes

- **2026-11-02** `8be803988b57`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/abacatepay/apis/api-abacatepay/changes/sub-accounts/list/get.md)

---

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