> The full uetr.ai documentation index is at https://uetr.ai/llms.txt, and every page under https://uetr.ai/docs/api is also Markdown at its address plus `.md`.

# Get the account

Get the account this API key or connected app acts on: its id, this user's role, the plan, and any scheduled deletion date. Check it to notice when that account changes or is ending. Reading changes nothing.

`GET https://uetr.ai/api/v1/account`

- MCP tool: `get_account`
- Access: any key or connection

## Response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `account` | object | Yes |  |
| `account.id` | string (uuid) | Yes | The account id. It changes if the key starts acting on another account. |
| `account.role` | `owner`, `member` | Yes | This user's role in the account. |
| `account.plan` | object | Yes |  |
| `account.plan.id` | string | Yes | free, rescue, monitor, monitor_20, or operator for the retired Operator plan. |
| `account.plan.name` | string | Yes |  |
| `account.subscription_status` | `active`, `payment_due`, `ended` or null | Yes | For a subscription plan: active, payment_due or ended. Null otherwise. |
| `account.scheduled_deletion_at` | string or null | Yes | When the account is scheduled to be deleted, or null. |
| `credential` | object | Yes |  |
| `credential.id` | string (uuid) | Yes |  |
| `credential.scope` | `read`, `read_write` | Yes |  |
| `credential.api_version` | string | Yes | The version this credential's requests use when they send no Uetr-Version header: the version it was created on, while that version is served. |

## Example

```sh
curl -X GET "https://uetr.ai/api/v1/account" \
  -H "Authorization: Bearer $UETR_API_KEY"
```

The answer:

```json
{
  "account": {
    "id": "5e8a1c3f-7b2d-4e6a-9f0c-1d3b5a7c9e2f",
    "role": "owner",
    "plan": {
      "id": "monitor",
      "name": "Monitor"
    },
    "subscription_status": "active",
    "scheduled_deletion_at": null
  },
  "credential": {
    "id": "9a7b5c3d-1e2f-4a6b-8c0d-2e4f6a8b0c1d",
    "scope": "read",
    "api_version": "2026-10-14"
  }
}
```

## Refusals

Besides the [access refusals](/docs/api/errors#access-refusals) every call can meet, this call can answer:

- None of its own.