---
title: "Get the current user"
method: GET
path: "/me"
tags: ["principal"]
---

# Get the current user

`GET /me`

## Request

- Base URL: `https://api.aquavoice.com/v1`
- URL: `https://api.aquavoice.com/v1/me`
- Auth: HTTP bearer

This operation remains available when privacy or enterprise retention
policy blocks stored history; in that case `history_available` is
false.

## Response `200`

Current user and credential.

- Principal
  - `id` string, required
  - `object` 'user', required
  - `email` string, email, required
  - `name` string, nullable, required
  - `created_at` string, date-time, nullable, required
  - `credential` Credential, required
    - `id` string, nullable, required
    - `method` 'api_key' | 'oauth', required
    - `scopes` string[], required: For an API key, the read and write scopes of the key; a key with full access has both. `write` includes `read`.
  - `plan` 'free' | 'pro' | 'max' | 'team' | 'enterprise', required
  - `privacy_mode` boolean, required
  - `history_available` boolean, required: True when enterprise policy permits stored history.

## Other responses

- `default`: Product API error.

---

[API](https://skmtc.dev/aquavoice/apis/aqua-api.md) - [All operations](https://skmtc.dev/aquavoice/apis/aqua-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aquavoice/apis/aqua-api/revisions/f0139c07aded?raw)