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

# Users

> Read and update the current Finup user profile.

The current-user endpoints use the authenticated user from the request credentials.

<Note>
  These endpoints are documented manually because the current filtered public OpenAPI source does not include them yet.
</Note>

## Get current user

```http theme={null}
GET /user
x-api-key: <key>
```

Returns the current user profile. Unlike most endpoints, this response is **not** wrapped in a `result` envelope.

```json theme={null}
{
  "id": "66b9d4f5a22f2a00124a1c5e",
  "first_name": "Alex",
  "last_name": "Morgan",
  "email": "alex@example.com",
  "email_confirmed": true,
  "two_factor_status": "enabled",
  "role": "owner",
  "balance": "1000.00"
}
```

| Field | Type | Description |
| - | - | - |
| `id` | string | User id. |
| `first_name` | string | Given name. |
| `last_name` | string | Family name. |
| `email` | string | Account email. |
| `email_confirmed` | boolean | Whether the email has been confirmed. |
| `two_factor_status` | string | `enabled` or `inactive`. |
| `role` | string | Flat role string. Custom roles report `employee`. |
| `balance` | string | Wallet balance as a decimal string in USD. |

<Note>
  The response also carries frontend-oriented fields (`role_details`, `permissions`, `avatar`, `avatar_seed`, `intercom_user_jwt`) that API integrations do not need.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.