Listar subcontas

Changed on

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

get/sub-accounts/list

Request

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

Query parameters

afterstring

Cursor para buscar itens após este ponto (use o publicId retornado em pagination.next).

beforestring

Cursor para buscar itens antes deste ponto (use o publicId retornado em pagination.before).

limitinteger
Example:100

Quantidade de itens por página (1-100).

startDatestring date
Example:2026-01-01

Filtra registros criados a partir desta data (inclusive). Formato YYYY-MM-DD. O intervalo é interpretado no fuso horário America/Sao_Paulo (00:00 do dia inicial).

endDatestring date
Example:2026-01-31

Filtra registros criados até esta data (inclusive). Formato YYYY-MM-DD. O intervalo é interpretado no fuso horário America/Sao_Paulo (23:59:59.999 do dia final).

taxIdstring
Example:11144477735

Filtrar pelo CPF ou CNPJ do titular, com ou sem máscara.

externalIdstring
Example:vendedor-42

Filtrar pelo identificador no seu sistema.

Response

Lista de subcontas.

successboolean

Se a requisição obteve sucesso ou não.

errorstring nullable

Example response

{
  "data": [
    {
      "id": "sacc_9f8Kq2LmX4vTzR7pWn3bYc1H",
      "name": "João da Silva",
      "taxId": "11144477735",
      "externalId": "vendedor-42",
      "balance": {
        "available": 7000
      },
      "metadata": {
        "loja": "centro"
      },
      "createdAt": "2026-10-26T14:22:10.381Z",
      "updatedAt": "2026-10-26T14:22:10.381Z"
    }
  ],
  "success": true
}

Changes