Detalhar conta bancária

Busca os dados de uma conta bancária específica que pertence à empresa cadastrada. A resposta inclui informações detalhadas da conta, como dados do titular, dados bancários e status da conta.

Operação em subconta: Para buscar uma conta bancária específica de uma subconta, inclua o header x-subaccount-id com o ID da subconta. Quando este header é fornecido, a operação será realizada no contexto da subconta especificada, em vez da conta principal autenticada.

GET /bank_accounts/{bankAccountId}

cURL

cURL

curl --request GET \
  --url https://sandbox-api.superpagamentos.com/bank_accounts/{bankAccountId} \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "id": 1,
    "holderName": "Empresa Teste LTDA",
    "bankCode": "001",
    "routingNumber": "0001-00",
    "accountNumber": "12345678-00",
    "document": "12345678000199",
    "accountType": "CHECKING",
    "status": "APPROVED",
    "createdAt": "2025-05-14T17:30:26.877Z"
  },
  "message": "Conta bancária encontrada com sucesso"
}

Authorizations

Authorization · string · header · required

Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no formato: Bearer

Headers

x-subaccount-id · string<uuid>

ID da subconta onde a operação será realizada. Quando fornecido, a operação será executada no contexto desta subconta específica.

Path Parameters

bankAccountId · integer · required

Identificador único da conta bancária

Response

200

application/json

Conta bancária encontrada com sucesso

data · object

Dados da conta bancária

Show child attributes

message · string

Example:

"Conta bancária encontrada com sucesso"