---
title: "Get Me"
method: GET
path: "/v1/me"
tags: ["identity"]
---

# Get Me

`GET /v1/me`

## Request

- Base URL: `https://api.usekeel.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usekeel.io/v1/me`
- Auth: none declared

Return the current principal's profile, org, and entitlements.

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable

## Response `200`

Successful Response

- MeResponse
  - `principal` PrincipalResponse, required
    - `id` string, required
    - `type` string, required
    - `display_name` string, required
    - `created_at` string, date-time, required
  - `org` OrgResponse, required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `plan` string, required
    - `status` string, required
    - `metadata` object
    - `created_at` string, date-time, required
  - `entitlements` EntitlementBalance[], required
    - `unit` string, required
    - `type` string, required
    - `granted` integer, required
    - `spent` integer, required
    - `reserved` integer, required
    - `available` integer, required
    - `enabled` boolean, nullable
    - `cap_current` integer, nullable
    - `period` string, nullable
    - `resets_at` string, nullable
    - `first_week` FirstWeekBlock: An active first-week welcome grant on one unit (connect-onboarding §1.8). The wire shape of :meth:`platform_auth.quota.FirstWeek.to_dict`: ``granted`` is the grant's own delta, ``remaining`` what is left of it (``WELCOME_POOL_SQL``), ``ends_at`` its expiry (ISO-8601, ``Z``). The key is ABSENT -- not null -- whenever no welcome grant is active; the serializers below drop a ``None``.
      - `granted` integer, required
      - `remaining` integer, required
      - `ends_at` string, required
    - `unlimited` boolean, required: Whether this grant is unbounded — SERVED, so no client needs the sentinel (Q-1614). ``granted`` carries ``platform_auth.config.UNLIMITED`` (INT_MAX) for an unlimited plan, a storage artifact whose only job is to not be rendered. keel-app had re-typed that literal in three places with nothing comparing the copies, and a single miss shows a user a nine-digit quota. A computed field cannot be passed in and cannot drift: it is recomputed from ``granted`` on every response, by the same test ``platform_auth.quota.QuotaView`` applies.
  - `credential_scopes` string[], nullable
  - `plan_status` PlanStatusResponse: spec 04 R2 plan_status block on GET /v1/me — built by platform_auth.pricing.plan_status_summary from the same sources as /pricing.md (plans.yaml, PLAN_BUILDER_FEE_BPS, PLAN_PRICES_USD).
    - `plan` string, required
    - `builder_fee_bps` union, required
      - integer
      - number
    - `limits` object, required
    - `remaining` object, required
    - `quotas` QuotaBlock[]
      - `unit` string, required
      - `label` string, required
      - `limit` integer, nullable
      - `used` integer, nullable
      - `remaining` integer, nullable
      - `unlimited` boolean
      - `period` string, nullable
      - `resets_at` string, nullable
      - `seconds_to_reset` integer, nullable
      - `first_week` FirstWeekBlock: An active first-week welcome grant on one unit (connect-onboarding §1.8). The wire shape of :meth:`platform_auth.quota.FirstWeek.to_dict`: ``granted`` is the grant's own delta, ``remaining`` what is left of it (``WELCOME_POOL_SQL``), ``ends_at`` its expiry (ISO-8601, ``Z``). The key is ABSENT -- not null -- whenever no welcome grant is active; the serializers below drop a ``None``.
        - `granted` integer, required
        - `remaining` integer, required
        - `ends_at` string, required
    - `upgrade_options` PlanUpgradeOption[], required
      - `plan` string, required
      - `price` object, required
      - `what_changes` object, required
    - `manage_url` string, required
  - `paper_enabled` boolean

## Other responses

- `422`: Validation Error

---

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