Help / API

GET /v1/me

Return the profile of the user the token authenticates, plus a summary of their 42min account (organization).

Headers

Authorization: Bearer <token>

Query parameters

None.

Response

{
  "data": {
    "user": {
      "id": "01HXXX…",
      "username": "ada",
      "email": "ada@example.com",
      "name": "Ada Lovelace",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "timezone": "Europe/London",
      "locale": "en",
      "avatar_url": "https://…"
    },
    "organization": {
      "id": "01HYYY…",
      "name": "Acme",
      "plan": "Pro"
    }
  },
  "meta": { "request_id": "req_…" }
}

Field notes:

• username is the user's slug (https://42min.us/<username>).
• name is first_name + " " + last_name, trimmed. null if both are empty.
• organization.plan is the name of the active plan, or null if no plan record is attached.

curl

curl -H "Authorization: Bearer $TOKEN" https://api.42min.us/v1/me

Common errors

• 403 insufficient_scope: token doesn't carry user:read.
• 404 not_found: the user behind the token has been deleted (rare — revocation usually invalidates the token first).