---
title: "Get the current token"
method: GET
path: "/api/v1/me"
tags: ["API Reference"]
---

# Get the current token

`GET /api/v1/me`

## Request

- Base URL: `https://revnu.com`
- URL: `https://revnu.com/api/v1/me`
- Auth: HTTP bearer

Who this token is: label, scopes, the account it belongs to, whether the account is still in setup, and the rate limits it is held to. Needs no scope.

**Response.** ```json
{
  "me": {
    "tokenId": "…",
    "label": "wall dashboard",
    "scopes": ["review:read", "review:write"],
    "createdAt": 1789837627802,
    "lastUsedAt": 1789851456304,
    "account": { "id": "…", "name": "Acme" },
    "inSetup": false,
    "limits": {
      "reads": { "perMinute": 300, "burst": 600 },
      "writes": { "perMinute": 60, "burst": 120 },
      "messages": { "perMinute": 30, "burst": 60 },
      "account": { "perMinute": 900, "burst": 1800 }
    }
  }
}
```

`lastUsedAt` and `account.name` can be `null`. `inSetup` is `true` while a self-serve account hasn't finished [setup](/docs/setup-status); until its trial starts, every other route except the setup routes answers `402 setup_pending`.

## Response `200`

{ me }

- object
  - `me` object, required
    - `tokenId` string, required
    - `label` string, required
    - `scopes` string[], required
    - `createdAt` number, required
    - `lastUsedAt` number, nullable, required
    - `account` object, required
      - `id` string, required
      - `name` string, nullable, required
    - `inSetup` boolean, required
    - `limits` object, required
      - `reads` object, required
        - `perMinute` number, required
        - `burst` number, required
      - `writes` object, required
        - `perMinute` number, required
        - `burst` number, required
      - `messages` object, required
        - `perMinute` number, required
        - `burst` number, required
      - `account` object, required
        - `perMinute` number, required
        - `burst` number, required

## Other responses

- `401`: Missing, unknown or revoked token
- `429`: Over the read limit; wait Retry-After seconds
- `503`: Temporarily unavailable; retry the same call.

---

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