All pages

Developer docs

Get the account

View as Markdown

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.

GEThttps://uetr.ai/api/v1/account
  • MCP tool: get_account
  • Access: any key or connection

Response

FieldTypeRequiredDescription
accountobjectYes
account.idstring (uuid)YesThe account id. It changes if the key starts acting on another account.
account.roleowner, memberYesThis user's role in the account.
account.planobjectYes
account.plan.idstringYesfree, rescue, monitor, monitor_20, or operator for the retired Operator plan.
account.plan.namestringYes
account.subscription_statusactive, payment_due, ended or nullYesFor a subscription plan: active, payment_due or ended. Null otherwise.
account.scheduled_deletion_atstring or nullYesWhen the account is scheduled to be deleted, or null.
credentialobjectYes
credential.idstring (uuid)Yes
credential.scoperead, read_writeYes
credential.api_versionstringYesThe 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.