> Markdown version of https://authpi.com/docs/reference/core-api/me/ — fetch the complete AuthPI docs index at https://authpi.com/llms.txt to discover all available pages.

# Me — AuthPI Core API

Caller identity. Answers "who does the Core API consider me to be?" for the presented credential — the credential's type and the verified accounts it can act on. Use it to resolve the account for an API key without configuration.

## GET /v1/me

**Get Caller Identity**

Returns who the Core API considers the caller to be, based on the presented credential — the equivalent of AWS STS `GetCallerIdentity`.

The response has one uniform shape for every credential type:

- **`type`** identifies the credential: `api_key` (HTTP Basic), `user` (Bearer JWT), or `personal_token` (Bearer PAT).
- **`accounts`** is always an array of the **verified accounts** this credential can act on, each with the authorization scopes held on it. API keys yield exactly one entry; user tokens one per account membership; credentials with no account access yield an empty array.
- Each entry carries both `account_id` and the underlying `org_id` — accounts are facades over organizations in AuthPI's own issuer.

Use this to resolve the account for a credential without configuration: when `accounts` has exactly one entry, that is the account to operate on. The admin SDKs use this endpoint to make `accountId` optional.

### Responses

| Code | Description | Schema |
| --- | --- | --- |
| 200 | The caller's identity and verified account access | `object` |
| 401 | **Unauthorized** - Authentication is required or has failed. | `ApiError` |