Consulta de Conta

Retorna informações detalhadas de uma conta específica vinculada ao perfil autenticado (Pessoa Física ou Jurídica).

Este endpoint permite consultar os dados completos de uma conta bancária associada ao perfil autenticado (Pessoa Física ou Jurídica).

O accountId deve ser informado na URL e pode ser obtido através do endpoint Consulta de Perfil — Pessoa Física ou Jurídica, no campo accounts[].id.

O retorno contém informações bancárias essenciais, incluindo:

• Banco (bank)

• Agência (agency)

• Número da conta (number)

• Saldo atual (balance)

• Status da conta (status)

• Indicador de conta de custódia (isEscrow)

• Conta de investimento (investmentAccount), quando aplicável

Este endpoint é protegido e requer o uso do cabeçalho Authorization: Bearer <token> e x-tenant-id

Endpoint para consulta

GET /accounts/{accountId}

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>
x-tenant-id	Tenant ID

Response

200

{
  "account": {
    "id": "b36d114c-76b3-494a-8c16-7be06244bca8",
    "bank": "633",
    "agency": "0001",
    "number": "60301514",
    "balance": 213.5,
    "status": "APPROVED",
    "isEscrow": false,
    "investmentAccount": null
  }
}

404

{
    "code": "NOT_FOUND",
    "error": "Conta não encontrada",
    "message": "Conta não encontrada"
}