---
title: "Your account and plan"
method: GET
path: "/api/v1/user"
tags: ["Account"]
---

# Your account and plan

`GET /api/v1/user`

## Request

- Base URL: `https://everypage.co`
- URL: `https://everypage.co/api/v1/user`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://everypage.co/oauth/authorize`, token URL `https://everypage.co/oauth/token`, scopes: `profile`)

The caller's profile - `name`, `email`, `subscription` (`free`, `basic`, `pro`), `hasDealLicense`, the free-trial fields (`trialEligible`, `trialEndsAt`, `storageLimited`) and `created_at`. Scope `profile`. `isAdmin` is always false through the API (the internal flag is masked on every token-authenticated read).

## Response `200`

Account

- User
  - `name` string
  - `email` string, email
  - `subscription` 'free' | 'basic' | 'pro'
  - `isAdmin` boolean: Always false through the API: the internal admin flag is masked on every token-authenticated read, so third-party apps never see it.
  - `created_at` string, date-time
  - `hasDealLicense` boolean: True for lifetime-deal holders with an active deal license (their entitlement comes from the license rather than a subscription).
  - `trialEligible` boolean: True when the account can still start its one free trial of a paid plan.
  - `trialEndsAt` string, date-time: Present while the account is on a free trial it has not yet paid for; when the trial ends.
  - `storageLimited` boolean: True during an unpaid free trial - upload size and active-file limits stay at the free plan's until the plan starts.

## Other responses

- `401`: No or invalid API key, OAuth token, manage token or claim token (code `missing_token` or `invalid_token`).
- `429`: Over the limit - 120 requests per minute per Authorization value on /api/v1 (webhook test 10/min; the Canva lane 30/min per IP). Code `rate_limited`; wait for `Retry-After`.

---

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