# Consulta de Conta

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

<mark style="color:green;">`GET`</mark> `/accounts/{accountId}`

**Headers**

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

**Response**

{% tabs %}
{% tab title="200" %}

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

```

{% endtab %}

{% tab title="404" %}

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

{% endtab %}
{% endtabs %}
