---
title: "List your tokens"
method: GET
path: "/access-tokens"
tags: ["Access tokens"]
---

# List your tokens

`GET /access-tokens`

## Request

- Base URL: `https://gorest.co.in/public/v3`
- URL: `https://gorest.co.in/public/v3/access-tokens`
- Auth: HTTP bearer

Every token of your account, the primary one first, then the newest. An account has at most 50, so the list is one page. The values are never shown again.

## Headers

- `If-None-Match` string

## Response `200`

Your tokens.

- AccessTokenList
  - `data` AccessToken[], required
    - `created_at` string, date-time, required
    - `expires_at` string, date-time, nullable, required: When the token stops working; null for an older token with no end.
    - `id` string, uuid, required
    - `is_primary` boolean, required: The account's first token; it cannot be revoked.
    - `label` string, required
    - `last4` string, required: The last 4 characters of the value.
    - `made_by` string, uuid, nullable, required: The token that made this one here; revoking that token revokes this one too. null for a token made on the site.
    - `rate_limit` integer, required: Calls a minute.
    - `scopes` Scope[], required
  - `meta` ListMeta, required
    - `has_more` boolean, required: More items follow this page.
    - `next_cursor` string, nullable, required: Send as `page[after]` for the next page; null on the last page and with offset paging.
    - `total` integer, nullable, required: All matching items; only with `page[number]` or `page[count]=true`, else null.

## Other responses

- `304`: Not changed since the ETag in `If-None-Match`; no body.
- `401`: No token, or the token is wrong, expired or revoked.
- `403`: The token lacks the scope this operation needs.
- `429`: Over the rate limit; wait `Retry-After` seconds.
- `500`: Something failed on the server.

---

[API](https://skmtc.dev/gorest/apis/gorest-api-v3.md) - [All operations](https://skmtc.dev/gorest/apis/gorest-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/gorest/apis/gorest-api-v3/revisions/89aa429755a6?raw)