> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Obter usuário atual

> Obter as informações de perfil do usuário autenticado

Este endpoint retorna as informações de perfil do usuário atualmente autenticado, incluindo seu saldo da conta.

### Resposta

<ResponseField name="name" type="string">
  O nome completo do usuário
</ResponseField>

<ResponseField name="email" type="string">
  O endereço de email do usuário
</ResponseField>

<ResponseField name="total_balance" type="number">
  O saldo atual da conta do usuário em USD
</ResponseField>

<ResponseExample>
  ```json 200 Resposta theme={null}
  {
    "name": "João Silva",
    "email": "joao.silva@exemplo.com",
    "total_balance": 125.50
  }
  ```
</ResponseExample>

### Casos de Uso

Este endpoint é útil para:

* **Verificar autenticação** - Confirmar se a chave da API é válida e pertence ao usuário esperado
* **Verificar saldo da conta** - Monitorar créditos disponíveis antes de fazer chamadas da API
* **Exibir informações do usuário** - Mostrar o usuário atual na interface da sua aplicação