---
title: "Check your account status: subscription tier plus monthly operations used and remaining."
method: GET
path: "/v1/agents/whoami"
tags: ["agents", "mcp"]
---

# Check your account status: subscription tier plus monthly operations used and remaining.

`GET /v1/agents/whoami`

## Request

- Base URL: `https://api.superdocs.app`
- URL: `https://api.superdocs.app/v1/agents/whoami`
- Auth: HTTP bearer

Check your SuperDocs account status: tier, monthly operations used/remaining, and (for agent accounts) whether a human has adopted it.

Call this with your `sk_` key. Useful before doing work (to confirm you have
operations left) and before signing up again (to reuse your account).

Nearing your monthly cap and need to keep going? Hand the account to a human:
POST /v1/agents/handoff with their email returns a one-time takeover code to
give them; they open the emailed link, enter the code, and adopt the account
in place (your work and this API key keep working) so they can upgrade and
pay. No human? POST /v1/agents/request-upgrade instead. Full flow:
https://docs.superdocs.app/introduction/agent-signup

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- AgentWhoamiResponse
  - `account_id` string, required
  - `tier` string, required
  - `quota` AgentQuota, required
    - `tier` string, required
    - `monthly_limit` integer, required
    - `used` integer, required
    - `remaining` integer, required
    - `resets_at` string, nullable
  - `is_agent_account` boolean, required
  - `adopted` boolean, nullable: For agent accounts: whether a human has adopted it yet. Null for regular accounts.
  - `hint` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superdocs/apis/universal-document-ai-api.md) · [All operations](https://skmtc.dev/superdocs/apis/universal-document-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superdocs/apis/universal-document-ai-api/revisions/37d03122940b?raw)