--- title: "List service tokens" method: GET path: "/organizations/{organization}/service-tokens" tags: ["Service tokens"] --- # List service tokens `GET /organizations/{organization}/service-tokens` List service tokens for an organization. ### Authorization A service token must have at least one of the following access in order to use this API endpoint: **Service Token Accesses** `read_service_tokens` ## Path parameters - `organization` string, required ## Query parameters - `page` integer - `per_page` integer ## Response `200` Returns the organization's service tokens - object - `type` string, required — The response type. Always "list" for paginated responses. - `current_page` integer, required — The current page number - `per_page` integer, required — The maximum number of results per page - `next_page` integer, nullable, required — The next page number, or null when this is the last page - `next_page_url` string, nullable, required — The next page of results, or null when this is the last page - `prev_page` integer, nullable, required — The previous page number, or null when this is the first page - `prev_page_url` string, nullable, required — The previous page of results, or null when this is the first page - `total_count` integer, required — The total number of matching results - `total_pages` integer, required — The total number of pages of matching results - `data` object[], required - `id` string, required — The ID of the service token - `name` string, nullable, required — The name of the service token - `display_name` string, required — The display name of the service token - `token` string, nullable — The plaintext token. Available only after create. - `plain_text_refresh_token` string, nullable — The plaintext refresh token. Available only after create. - `avatar_url` string, required — The image source for the avatar of the service token - `created_at` string, required — When the service token was created - `updated_at` string, required — When the service token was last updated - `expires_at` string, nullable, required — When the service token will expire - `last_used_at` string, nullable, required — When the service token was last used - `actor_id` string, nullable, required — The ID of the actor on whose behalf the service token was created - `actor_display_name` string, nullable, required — The name of the actor on whose behalf the service token was created - `actor_type` string, nullable, required — The type of the actor on whose behalf the service token was created - `service_token_accesses` object[], nullable - `id` string, required — The ID of the service token access - `access` string, required — The name of the service token access - `description` string, required — The description of the service token access - `resource_name` string, required — The name of the resource the service token access gives access to - `resource_id` string, required — The ID of the resource the service token access gives access to - `resource_type` string, required — The type of the resource the service token access gives access to - `resource` object, required - `id` string, required — The ID for the resource - `name` string, required — The name for the resource - `created_at` string, required — When the resource was created - `updated_at` string, required — When the resource was last updated - `deleted_at` string, nullable, required — When the resource was deleted, if deleted - `oauth_accesses_by_resource` object, nullable - `database` object, required - `databases` object[], required - `name` string, required — the name of the database the token has access to - `id` string, required — the id of the database the token has access to - `organization` string, required — the name of the database's organization - `url` string, required — the planetscale app url for the database - `accesses` object[], required - `name` string, required — The name of the access scope - `description` string, required — The scope description - `organization` object, required - `organizations` object[], required - `name` string, required — the name of the organization - `id` string, required — the id of the organization - `url` string, required — the planetscale app url for the organization - `accesses` object[], required - `name` string, required — The name of the access scope - `description` string, required — The scope description - `branch` object, required - `branches` object[], required - `name` string, required — the name of the branch - `id` string, required — the id of the branch - `database` string, required — the name of the database the branch belongs to - `organization` string, required — the name of the organization the branch belongs to - `url` string, required — the planetscale app url for the branch - `accesses` object[], required - `name` string, required — The name of the access scope - `description` string, required — The scope description - `user` object, required - `users` object[], required - `name` string, required — the name of the user - `id` string, required — the id of the user - `accesses` object[], required - `name` string, required — The name of the access scope - `description` string, required — The scope description ## Other responses - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found - `500` — Internal Server Error ## Changes - **2026-08-11** `4b2e4f05bda2` — 3 info - added the required property `per_page` to the response with the `200` status - added the required property `total_count` to the response with the `200` status - added the required property `total_pages` to the response with the `200` status - **2026-06-01** `72506953f367` — 19 breaking, 1 info - the response property `data/items/actor_display_name` became nullable for the status `200` - the response property `data/items/actor_id` became nullable for the status `200` - the response property `data/items/actor_type` became nullable for the status `200` - the response property `data/items/expires_at` became nullable for the status `200` - …16 more - **2025-12-09** `d710019068fb` — 2 breaking - for the `query` request parameter `page`, the type/format was changed from `number`/`` to `integer`/`` - for the `query` request parameter `per_page`, the type/format was changed from `number`/`` to `integer`/`` - **2025-12-04** `5e881928d77a` — 1 info - endpoint added [Change history](https://skmtc.dev/planetscale/apis/planetscale-api/changes/organizations/:organization/service-tokens/get.md) --- [API](https://skmtc.dev/planetscale/apis/planetscale-api.md) · [All operations](https://skmtc.dev/planetscale/apis/planetscale-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/planetscale/planetscale-api/revisions/d3bf8cec0492/schema)