> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar contas bancárias

> Lista contas bancárias.

Retorna uma página de `payout_account` no payload de lista canônico. A listagem é
escopada pela organização atuante: API key de organização lista contas da
própria organização; API key de plataforma lista contas da organização
conectada a ela, indicada no header `Organization`. Contas desconectadas da
organização atuante não aparecem na lista.

Para exibir apenas a conta principal atual no admin da plataforma, prefira
[`GET /v1/organizations/{id}`](/api-reference/organizations/get) e leia
`organization.payout_account`. Use a listagem quando precisar mostrar histórico
de contas conectadas ou quando ainda não tiver o `pa_*` de uma conta específica.

## Autenticação

| Credencial             | Acesso                                                   |
| ---------------------- | -------------------------------------------------------- |
| API key da organização | Apenas a própria organização da key.                     |
| API key da plataforma  | Organização conectada indicada no header `Organization`. |

## Parâmetros de query

<ParamField query="limit" type="integer" default="10">
  Itens por página. Máximo `100`.
</ParamField>

<ParamField query="starting_after" type="string">
  Cursor para buscar a próxima página depois do ID informado.
</ParamField>

<ParamField query="ending_before" type="string">
  Cursor para buscar a página anterior antes do ID informado.
</ParamField>

<ParamField query="is_active" type="boolean">
  Filtra a conta principal (`true`) ou contas anteriores (`false`). Esse campo
  não informa se os repasses foram creditados.
</ParamField>

<ParamField query="is_verified" type="boolean">
  Filtro informativo. O valor não representa elegibilidade para recebimentos;
  não o use para decidir se uma conta pode receber repasses.
</ParamField>

<ParamField query="type" type="string">
  Filtra pelo tipo da conta para saques.

  | Valor      | Descrição       |
  | ---------- | --------------- |
  | `checking` | Conta corrente. |
  | `savings`  | Conta poupança. |
</ParamField>

<ParamField query="created[gte]" type="string">
  Filtra contas criadas a partir deste timestamp.
</ParamField>

<ParamField query="created[gt]" type="string">
  Filtra contas criadas depois deste timestamp.
</ParamField>

<ParamField query="created[lte]" type="string">
  Filtra contas criadas até este timestamp.
</ParamField>

<ParamField query="created[lt]" type="string">
  Filtra contas criadas antes deste timestamp.
</ParamField>

```bash cURL theme={"theme":"css-variables"}
curl -X GET "https://api.chargefy.io/v1/payout-accounts?limit=10&is_active=true" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Organization: org_HamUxDFN6Jy4F7Mc"
```

## Resposta

<ResponseField name="object" type="string">
  Sempre `"list"`.
</ResponseField>

<ResponseField name="data" type="array">
  Lista de objetos [`payout_account`](/api-reference/payout-accounts/object).
</ResponseField>

<ResponseField name="has_more" type="boolean">
  `true` quando existe próxima página.
</ResponseField>

<ResponseField name="url" type="string">
  Caminho canônico da coleção: `/v1/payout-accounts`.
</ResponseField>

```json 200 theme={"theme":"css-variables"}
{
  "object": "list",
  "data": [
    {
      "id": "pa_PFsmG18brKR11HFD",
      "object": "payout_account",
      "account_number_last4": "5678",
      "bank_code": "001",
      "bank_name": "Banco Exemplo S.A.",
      "created_at": "2026-05-16T14:09:27Z",
      "holder_name": "Acme Ltda",
      "is_active": true,
      "is_verified": false,
      "livemode": true,
      "metadata": {},
      "routing_number": "0001",
      "type": "checking",
      "updated_at": "2026-05-16T14:20:00Z"
    }
  ],
  "has_more": false,
  "url": "/v1/payout-accounts"
}
```

## Erros

| Status | Quando                                                   |
| ------ | -------------------------------------------------------- |
| `401`  | Credencial ausente, inválida, revogada ou expirada.      |
| `403`  | Credencial sem acesso à organização.                     |
| `409`  | Contas para saques ainda não são suportadas no sandbox.  |
| `500`  | Erro temporário listando contas para saques. Faça retry. |

```json 400 theme={"theme":"css-variables"}
{
  "error": {
    "code": "invalid_request",
    "message": "limit must be between 1 and 100.",
    "param": "limit",
    "type": "invalid_request_error"
  }
}
```

```json 401 theme={"theme":"css-variables"}
{
  "error": {
    "code": "authentication_failed",
    "message": "Invalid API key provided.",
    "type": "authentication_error"
  }
}
```