---
title: "Your plan and remaining budgets"
method: GET
path: "/v1/me"
tags: ["v1"]
---

# Your plan and remaining budgets

`GET /v1/me`

## Request

- Base URL: `https://api.themeparks.wiki`
- URL: `https://api.themeparks.wiki/v1/me`
- Auth: API key in header `X-API-Key`

Returns your plan and what is left of it: `tier`, how far back your history calls reach (`historyDays`, or `historyAllArchive: true` when you can read everything we hold), the earliest day you may ask for, and two budgets: `rateLimit`, the request limit every call counts against, and `historyRateLimit`, the hourly history budget. Each budget has `unmetered`; when it is false, it also has `limit`, `windowSeconds`, `remaining` and `reset`, the same figures as the RateLimit headers. Use it on an unmetered plan, which gets no such headers, or to check your history budget without spending it. The call counts as one ordinary request and needs an API key.

## Response `200`

Successful response

- V1Me: Your plan and what is left of it. `rateLimit` is the request limit every call counts against, this one included. `historyRateLimit` is the hourly budget the history calls count against; reading it here does not spend it. Figures are per account, so every key on one account reports the same.
  - `tier` string, required: Your plan, e.g. "free", "pro", "business", "enterprise".
  - `historyDays` integer, nullable, required: How many days back your history calls may reach, today included. null when `historyAllArchive` is true.
  - `historyAllArchive` boolean, required: true when this key can read everything we hold for an entity, back to the first day we recorded it. `historyDays` and `historyEarliestDate` are then null.
  - `historyEarliestDate` string, date, nullable, required: The earliest day (YYYY-MM-DD) a history call may ask for, computed in UTC. Each park counts days in its own time zone, so near midnight this can be off by one. Earlier days answer 403 HISTORY_WINDOW_EXCEEDED. null when `historyAllArchive` is true.
  - `rateLimit` V1MeBudget, required: One budget: the same figures the RateLimit-* and RateLimit-History-* headers carry.
    - `unmetered` boolean, required: true when this budget is not metered on your plan. The other fields are then absent, and no RateLimit headers are sent for it.
    - `limit` integer: Requests allowed per window.
    - `windowSeconds` integer: Window length in seconds.
    - `remaining` integer, nullable: Requests left in the current window; null if it could not be read just now.
    - `reset` integer, nullable: Seconds until the window resets; null if nothing has been counted in this window yet, or if it could not be read.
  - `historyRateLimit` V1MeBudget, required: One budget: the same figures the RateLimit-* and RateLimit-History-* headers carry.
    - `unmetered` boolean, required: true when this budget is not metered on your plan. The other fields are then absent, and no RateLimit headers are sent for it.
    - `limit` integer: Requests allowed per window.
    - `windowSeconds` integer: Window length in seconds.
    - `remaining` integer, nullable: Requests left in the current window; null if it could not be read just now.
    - `reset` integer, nullable: Seconds until the window resets; null if nothing has been counted in this window yet, or if it could not be read.

## Other responses

- `401`: Authentication failed
- `429`: Too many requests. Wait `retryAfter` seconds (also the Retry-After header).
- `503`: Response

## Changes

- **2026-09-27** `f12e25418ddc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/themeparks/apis/v1-api/changes/v1/me/get.md)

---

[API](https://skmtc.dev/themeparks/apis/v1-api.md) - [All operations](https://skmtc.dev/themeparks/apis/v1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/themeparks/apis/v1-api/revisions/a9f0cb93c745?raw)