The GET /tokens endpoint returns all tokens that belong to your workspace. You can filter results by status or name, and paginate through large sets using the page and per_page query parameters. The response always includes a meta object so you know the total number of tokens and how many pages remain.
Required scope: tokens:readQuery parameters The page number to retrieve. Starts at 1. Use alongside per_page to paginate through results.
Number of tokens to return per page. Minimum is 1, maximum is 100.
Filter tokens by their current status. Accepted values are active, expired, and revoked. Omit this parameter to return tokens in all states.
Filter tokens by name using a partial, case-insensitive match. For example, ?name=ci returns tokens named ci-deploy and CI Pipeline Token.
Request curl --request GET \ --url "https://api.tooken.io/v1/tokens?page=1&per_page=25&status=active" \ --header "Authorization: Bearer tok_live_xxxxxxxxxxxxxxxxxxxx"
Response A successful request returns 200 OK with the following body.
An array of token objects for the current page. Show token object properties
The unique identifier for the token. Format: tok_a1b2c3d4e5f6g7h8i9j0k1l2.
The human-readable name assigned to the token at creation.
The list of permission scopes granted to this token (for example, ["tokens:read", "tokens:write"]).
The current state of the token. One of active, expired, or revoked.
ISO 8601 datetime when the token was created.
ISO 8601 datetime when the token expires. null if the token has no expiration.
ISO 8601 datetime of the most recent authenticated request made with this token. null if the token has never been used.
The email address of the workspace member who created the token.
Pagination metadata for the current response. The number of items returned per page.
The total number of tokens matching the current filter, across all pages.
Example response { "data" : [ { "id" : "tok_a1b2c3d4e5f6g7h8i9j0k1l2" , "name" : "CI Deploy Token" , "scopes" : [ "tokens:read" , "tokens:write" ], "status" : "active" , "created_at" : "2026-01-15T09:00:00Z" , "expires_at" : "2027-01-15T09:00:00Z" , "last_used_at" : "2026-04-27T14:32:00Z" , "created_by" : "alice@example.com" }, { "id" : "tok_b2c3d4e5f6g7h8i9j0k1l2m3" , "name" : "Read-Only Audit Key" , "scopes" : [ "tokens:read" ], "status" : "active" , "created_at" : "2026-02-01T12:00:00Z" , "expires_at" : null , "last_used_at" : null , "created_by" : "bob@example.com" } ], "meta" : { "page" : 1 , "per_page" : 25 , "total" : 2 } }
