Developer docs
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
curl -X GET "https://uetr.ai/api/v1/account" \ -H "Authorization: Bearer $UETR_API_KEY"
The answer:
{
"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 every call can meet, this call can answer:
- None of its own.