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

# Obter uma conta bancária

> Retorna uma conta bancária pelo ID.

Retorna o objeto `payout_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 para saques ativa de uma organização conectada a uma
plataforma, normalmente basta ler `payout_account` em
[`GET /v1/organizations/{id}`](/api-reference/organizations/get).
Use este endpoint quando você já tem o `pa_*`, por exemplo a partir de
`organization.payout_account.id`, e precisa consultar esse recurso diretamente.

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

<ParamField path="id" type="string" required>
  ID da conta para saques (`pa_*`).
</ParamField>

```bash cURL theme={"theme":"css-variables"}
curl -X GET "https://api.chargefy.io/v1/payout-accounts/pa_JGx2RN4jHvBAUGf3" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Organization: org_jpr5YTWvjB8QUUZW"
```

## Resposta

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

```json 200 theme={"theme":"css-variables"}
{
  "id": "pa_JGx2RN4jHvBAUGf3",
  "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"
}
```

## Erros

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

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

```json 404 theme={"theme":"css-variables"}
{
  "error": {
    "code": "resource_missing",
    "message": "Payout account not found.",
    "param": "id",
    "type": "invalid_request_error"
  }
}
```