---
title: "Who the caller is, and what is left of their free preview"
method: GET
path: "/v1/me"
---

# Who the caller is, and what is left of their free preview

`GET /v1/me`

## Request

- Base URL: `https://lexiara.org`
- URL: `https://lexiara.org/v1/me`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

The identity behind this request, resolved the same way every other route resolves it: a presented API key, then a session cookie, then an anonymous preview. `signedIn` reports whether a session was found; `preview` carries the remaining allowance and is null for a keyed or signed-in caller. Reads no corpus table and asserts nothing about the law. Sign-in itself is a browser redirect flow (/auth/google/start), not an API call, so it is not specified here. Answerable anonymously, but NOT a public discovery route: it reports on the caller's own credential, so it inherits the global security.

## Response `200`

Caller identity and preview allowance.

## Other responses

- `401`: The free preview is used up (`error: preview_exhausted`); sign in to continue.

---

[API](https://skmtc.dev/lexiara/apis/lexiara.md) · [All operations](https://skmtc.dev/lexiara/apis/lexiara/llms.txt) · [OpenAPI document](https://skmtc.dev/lexiara/apis/lexiara/revisions/15a5f67f7586?raw)