Skip to main content
Get a Bank Account
curl --request GET \
  --url https://api.chargefy.io/v1/bank-accounts/{id}
{
  "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"
}
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}. 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

CredencialAcesso
JWT de usuárioRequer acesso à organização.
API key da organizaçãoApenas a própria organização da key.
API key da plataformaOrganização conectada indicada no header Organization.

​
Parâmetros de caminho

​
id
string
required
ID da conta bancária (ba_*).
cURL
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 completo. 
{
  "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"
}

​
Erros

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