---
title: "Get the authenticated account"
method: GET
path: "/v1/me"
tags: ["Account"]
---

# Get the authenticated account

`GET /v1/me`

## Request

- Base URL: `https://stashr.me`
- URL: `https://stashr.me/v1/me`
- Auth: HTTP bearer

Return the authenticated account and an access snapshot. Works on every plan (the only endpoint exempt from the Pro requirement), so it is the right connection check: hasProAccess says whether the rest of the API is usable right now.

## Response `200`

The authenticated account

- object
  - `data` Account, required
    - `access` object, required
      - `hasAppAccess` boolean, required
      - `hasPaidPlan` boolean, required
      - `hasProAccess` boolean, required: Whether the API and MCP are usable right now
      - `trial` object, nullable, required
        - `tagsRemaining` integer, required
        - `trialEndsAt` string, date-time, required
    - `email` string, email, required
    - `id` string, required
    - `image` string, nullable, required
    - `name` string, required

## Other responses

- `400`: Malformed request (error.code bad_request or invalid_json)
- `401`: Missing, invalid, or expired credentials (error.code unauthorized)
- `402`: A Pro plan or active trial is required (error.code payment_required)
- `403`: The credential lacks the required scope (error.code forbidden)
- `404`: The resource does not exist or belongs to another account (error.code not_found)
- `422`: Validation failed; error.details.issues lists the fields (error.code validation_error)
- `429`: Too many requests (error.code rate_limited); wait Retry-After seconds, also given as error.retryAfterMs
- `500`: Something failed on Stashr's side (error.code internal_error); retryable

---

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