---
title: "Get the current token"
method: GET
path: "/token"
tags: ["Tokens"]
---

# Get the current token

`GET /token`

## Request

- Base URL: `https://app.honeybadger.io/v3`
- URL: `https://app.honeybadger.io/v3/token`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/honeybadger/apis/honeybadger-api/docs/token/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the credential making the request and what it can reach. It needs no scope.

`project_ids` lists the projects the token can reach now; a user token loses a project as soon as its owner does.

## Response `200`

Success

- object
  - `data` object, required
    - `kind` 'user' | 'account' | 'oauth': `user` and `account` are scoped API tokens. `oauth` is an access token issued to an application acting for a user.
    - `name` string, nullable: The token's name. For an OAuth grant, the name the user gave the connection, or the application's name if none.
    - `scopes` string[]: Granular permissions. For an OAuth grant these are its legacy `read`/`write` aliases expanded to the API surface as it stood when the grant was consented to.
    - `account_id` string: ID of the account the credential is bound to.
    - `project_ids` string[]: IDs of the projects the credential can reach. Empty for a credential bound to an account with no visible projects; every project in the account when unrestricted.
    - `expires_at` string, date-time, nullable
    - `last_used_at` string, date-time, nullable: When the credential was last used before this request. Recorded at most once a minute, so it can lag by up to a minute; null on first use.
  - `meta` ResponseMeta
    - `request_id` string: Unique identifier for the request, for correlating with support

## Other responses

- `401`: The credential is missing, invalid, expired or revoked (`unauthorized`), or was sent in a way v3 doesn't accept (see the examples).

---

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