---
title: "Get authenticated principal"
method: GET
path: "/v1/me"
tags: ["Auth"]
---

# Get authenticated principal

`GET /v1/me`

## Response `200`

Authenticated principal and accessible organizations.

- object
  - `success` true, required
  - `data` Me, required
    - `principal` object, required
      - `type` 'session' | 'api_key' | 'oauth', required
      - `userId` string — Present for session and oauth principals. API keys are organization credentials and carry no acting user.
      - `keyId` string
      - `organizationId` string — The organization the API key belongs to (api_key principals only).
      - `createdBy` string — User who minted the API key. Attribution only, never authorization.
      - `activeOrganizationId` string, nullable
    - `activeOrganizationId` string, nullable, required
    - `organizations` Organization[], required
      - `organizationId` string, required
      - `organizationSlug` string, required
      - `organizationName` string, required
      - `role` string, required

## Other responses

- `401` — Authentication is missing, invalid, or expired.
- `402` — The requested operation requires a paid plan. API access (organization API keys) requires the Starter plan or higher; a downgraded organization receives this error until its plan is restored.
- `403` — The authenticated principal cannot access the resource.
- `500` — An unexpected internal error occurred.

---

[API](https://skmtc.dev/inth/apis/inth-api.md) · [All operations](https://skmtc.dev/inth/apis/inth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inth/inth-api/revisions/97262bd49ddd/schema)