---
title: "Get the calling account"
method: GET
path: "/v1/account"
tags: ["Accounts"]
---

# Get the calling account

`GET /v1/account`

## Request

- Base URL: `https://serp-agent.com`
- URL: `https://serp-agent.com/v1/account`
- Auth: HTTP bearer

Snapshot of the account behind the presented API key. Sandbox callers additionally see their usage ledger (`sandbox_usage`) and limits so an agent can self-manage the trial budget. `plan` is currently always `null` (populated by the upcoming billing phase).

## Response `200`

The account snapshot.

- Account
  - `account_id` string, required
  - `email` string, email, required
  - `email_verified` boolean, required
  - `mode` 'sandbox' | 'live', required: Mode of the key used on this request.
  - `plan` unknown, required
  - `sandbox_usage` object, nullable, required: Trial units consumed. Null for live keys.
    - `audits` integer
    - `articles` integer
  - `sandbox_limits` SandboxLimits, required: Hard caps on a sandbox trial key.
    - `audits` integer, required
    - `articles` integer, required
    - `expires_days` integer, required
  - `created_at` string, date-time, required
  - `projects_count` integer, required

## Other responses

- `401`: Missing, malformed, unknown, revoked, or expired API key. Codes: `unauthorized`, `key_revoked`, `key_expired`.
- `429`: Rate limit exceeded (600 requests/minute per API key). Honor `Retry-After`.

---

[API](https://skmtc.dev/serp-agent/apis/serp-agent-api.md) · [All operations](https://skmtc.dev/serp-agent/apis/serp-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/serp-agent/apis/serp-agent-api/revisions/438a943019ac?raw)