---
title: "Get Identity"
method: GET
path: "/api/me"
tags: ["Identity"]
---

# Get Identity

`GET /api/me`

Returns information about the authenticated caller and, if applicable, the organization they are scoped to.

Use this endpoint to confirm which kind of credential is being used before
calling endpoints with stricter authorization rules.

For user-scoped credentials, the response includes the resolved user and
organization details. For non-user keys, the response identifies the key class
with the corresponding boolean flags instead of impersonating a user.

This endpoint is especially useful when debugging why a request is being
accepted or rejected by endpoints that are limited to particular caller types.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- GetIdentityResponseEnvelope
  - `data` GetIdentityResponseSchema
    - `credential` IdentityCredentialSchema
      - `api_key_profile` IdentityCredentialAPIKeyProfileSchema
        - `capabilities` IdentityCredentialCapabilitiesSchema
          - `query` IdentityCredentialConnectionCapabilitySchema
            - `connection_ids` string[], nullable — Connection IDs enabled for this capability.
          - `schemas` IdentityCredentialConnectionCapabilitySchema
            - `connection_ids` string[], nullable — Connection IDs enabled for this capability.
        - `description` string — Organization-provided summary of the data and questions this scoped profile supports.
        - `id` string, uuid — Stable API key profile ID.
        - `kind` string — API key profile kind.
        - `name` string — Stable API key profile name.
      - `method` string — Authentication method used for the request.
      - `mode` string — API key mode applied to the credential when available.
      - `oauth_client_id` string, uuid — OAuth client ID for OAuth-issued API keys.
    - `email` string — The email of the caller.
    - `id` string, uuid — The ID of the caller; this will be omitted for non-user callers.
    - `is_organization` boolean — Whether the caller is using an organization key.
    - `is_partner` boolean — Whether the caller is using a partner key.
    - `is_system` boolean — Whether the caller is a system actor.
    - `is_user` boolean — Whether the caller is a user.
    - `organization_id` string, uuid — The ID of the organization the caller belongs to.
    - `organization_name` string — The name of the organization the caller belongs to.
    - `role` string — Deprecated legacy role name. Populated only for user callers.

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error

---

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