---
title: "Get account details"
method: GET
path: "/v1/account"
tags: ["Account"]
---

# Get account details

`GET /v1/account`

Self-service account summary plus API key inventory for the authenticated user.
Returns tier, monthly request limit and usage, trial status, and every API key (token hints only).

## Response `200`

Account and API key inventory

- object
  - `account` object
    - `email` string
    - `tier` string
    - `request_limit` integer
    - `usage_this_month` integer
    - `trial_active` boolean
    - `trial_ends_at` string, date-time, nullable
  - `api_keys` ApiKey[]
    - `id` string, uuid
    - `name` string, nullable — Optional label for the key
    - `token_hint` string — First 8 characters of the token
    - `active` boolean
    - `created_at` string, date-time
    - `revoked_at` string, date-time, nullable
    - `plain_token` string — Full token — only returned on create and roll responses
  - `docs` string

## Other responses

- `401` — Unauthorized
- `500` — Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1.md) · [All operations](https://skmtc.net/oilpriceapi/apis/oil-price-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oilpriceapi/oil-price-api-v1/versions/5a5ce424cacc/schema)