---
title: "Get My Access"
method: GET
path: "/v1/me/access"
tags: ["authz"]
---

# Get My Access

`GET /v1/me/access`

## Request

- Base URL: `https://api.4chems.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.4chems.com/v1/me/access`
- Auth: HTTP bearer

Return the caller's access level per related tenant. Call this to check
what the current caller is authorized to do before attempting an action
that requires a specific level, or to discover a pending invitation or
access request.

One entry per tenant the subject relates to via an active assignment, a
pending invitation to their verified email, or a pending access request
(ADR 0016 decision 6); a subject with no relation gets an empty list.
`subscription` is the tenant's `{state, expires_at, grace_ends_at}` (UC-096);
a standard tenant reports `active` with null dates.

## Response `200`

Successful Response

- TenantAccessOut[]
  - `tenant` string, required
  - `level` 'none' | 'requester' | 'viewer' | 'member' | 'admin' | 'owner', required
  - `via` string, required
  - `subscription` SubscriptionOut, required
    - `state` 'trialing' | 'expired' | 'erased' | 'active', required: Commercial state (UC-096, UC-086 D7); `TrialStatus` is provisioning only.
    - `expires_at` string, date-time, nullable, required
    - `grace_ends_at` string, date-time, nullable, required

---

[API](https://skmtc.dev/4chems/apis/platform-api.md) · [All operations](https://skmtc.dev/4chems/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/4chems/apis/platform-api/revisions/65e4f7b4dba0?raw)