> ## 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.

# Get a Bank Account

> Retorna uma conta bancária pelo ID.

Retorna o objeto `bank_account` completo. A resposta nunca inclui o número
completo da conta; use `account_number_last4` para identificar a conta exibida
ao usuário. Contas desconectadas da organização atuante retornam `404`.

Para exibir a conta bancária ativa de uma organização conectada, normalmente
basta ler `bank_account` em [`GET /v1/organizations/{id}`](/api-reference/organizations/get).
Use este endpoint quando você já tem o `ba_*`, por exemplo a partir de
`organization.bank_account.id`, e precisa consultar esse recurso diretamente.

## Autenticação

| Credencial             | Acesso                                                   |
| ---------------------- | -------------------------------------------------------- |
| JWT de usuário         | Requer acesso à organização.                             |
| 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 caminho

<ParamField path="id" type="string" required>
  ID da conta bancária (`ba_*`).
</ParamField>

```bash cURL theme={}
curl -X GET "https://api.chargefy.io/v1/bank-accounts/ba_123" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Organization: org_789"
```

## Resposta

`200 OK` com o objeto [`bank_account`](/api-reference/bank-accounts/object) completo.

<ResponseExample>
  ```json 200 theme={}
  {
    "id": "ba_123",
    "object": "bank_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"
  }
  ```
</ResponseExample>

## Erros

| Status | Quando                                                               |
| ------ | -------------------------------------------------------------------- |
| `401`  | Credencial ausente, inválida, revogada ou expirada.                  |
| `403`  | Credencial sem acesso à organização.                                 |
| `404`  | Conta bancária inexistente ou fora do escopo da organização atuante. |
| `409`  | Contas bancárias ainda não são suportadas no sandbox.                |
| `500`  | Erro temporário carregando a conta bancária. Faça retry.             |