Skip to main content
GET
/
me
Introspect the authenticated key, its organization, and credits
curl --request GET \
  --url https://api.samsa.ai/public/v1/me \
  --header 'Authorization: Bearer <token>'
{
  "organization": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
  },
  "api_key": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "prefix": "<string>",
    "scopes": [
      "<string>"
    ],
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "credits": {
    "available": 123
  }
}
Returns { organization, api_key, credits } for the presented key — the organization id and name, the key’s safe metadata (id, name, prefix, scopes, expiry — never the secret), and the organization’s available credit balance. This is the fastest way to confirm a key works. GET /me requires any valid key and no specific scope.

Authorizations

​
Authorization
string
header
required

Organization API key as a bearer token: Authorization: Bearer samsa_sk_....

Headers

​
authorization
string | null

Response

Successful Response

GET /me body — the quickstart smoke response (ADR §10, scope item 5).

​
organization
OrganizationInfo · object
required

The key's organization (the billing / rate-limit identity, ADR §3.1).

​
api_key
ApiKeyInfo · object
required

The presented key's safe, re-displayable metadata (never secrets).

​
credits
CreditsInfo · object
required

The organization's currently available credit balance.