Get token about

This page as Markdown, or in an AI chatMore ways to read this page

# Get token about

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-tokens-about

`GET /api/v1/tokens/about`

## The answer

200, `TokenAbout`: What the API tokens screen needs beside the tokens themselves.

- `now` (integer, needed)
- `per_hour` (integer, needed): Requests an hour one token may make.
- `scopes` (list of ScopeView, needed)
- `sites` (list of SiteRef, needed): The sites a token of this member's could be held to.
- `url` (string, needed): Where this tidekeeper is reached, for the example.

## Asking

```sh
curl https://tidekeeper.eu/api/v1/tokens/about \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```

The answer

Status 200

TokenAbout What the API tokens screen needs beside the tokens themselves.

now: integerneeded
per_hour: integerneededRequests an hour one token may make.
scopes: list of ScopeViewneeded
sites: list of SiteRefneededThe sites a token of this member's could be held to.
url: stringneededWhere this tidekeeper is reached, for the example.

Asking

curlJavaScript

With your token from Settings

curl https://tidekeeper.eu/api/v1/tokens/about \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN"

With your token from Settings

const answer = await fetch("https://tidekeeper.eu/api/v1/tokens/about", {
  headers: {
    Authorization: `Bearer ${process.env.TIDEKEEPER_TOKEN}`,
  },
}).then((r) => r.json());