---
title: "ListGithubTokens"
method: GET
path: "/v1/github-tokens"
tags: ["GithubTokenService"]
---

# ListGithubTokens

`GET /v1/github-tokens`

## Request

- Base URL: `https://api.endorlabs.com`
- URL: `https://api.endorlabs.com/v1/github-tokens`
- Auth: none declared

Lists all available GitHub tokens.

## Query parameters

- `filter` string
- `page_token` integer
- `page_size` integer
- `action` string
- `mask` string
- `traverse` boolean
- `sort.path` string
- `sort.order` 'SORT_ENTRY_ORDER_UNSPECIFIED' | 'SORT_ENTRY_ORDER_ASC' | 'SORT_ENTRY_ORDER_DESC'
- `count` boolean
- `group.aggregation_paths` string
- `group.show_aggregation_uuids` boolean
- `group.unique_count_paths` string
- `group.unique_value_paths` string
- `ci_run_uuid` string
- `page_id` string
- `group_by_time.aggregation_paths` string
- `group_by_time.show_aggregation_uuids` boolean
- `group_by_time.interval` 'GROUP_BY_TIME_INTERVAL_UNSPECIFIED' | 'GROUP_BY_TIME_INTERVAL_YEAR' | 'GROUP_BY_TIME_INTERVAL_QUARTER' | 'GROUP_BY_TIME_INTERVAL_MONTH' | 'GROUP_BY_TIME_INTERVAL_WEEK' | 'GROUP_BY_TIME_INTERVAL_DAY' | 'GROUP_BY_TIME_INTERVAL_HOUR' | 'GROUP_BY_TIME_INTERVAL_MINUTE' | 'GROUP_BY_TIME_INTERVAL_SECOND'
- `group_by_time.group_size` integer
- `group_by_time.start_time` string, date-time
- `group_by_time.end_time` string, date-time
- `group_by_time.mode` string
- `group_by_time.aggregation_value_field` string
- `group_by_time.aggregation_operator` string
- `disable_pagination` boolean

## Response `200`

A successful response.

- V1ListGithubTokensResponse: Response to the request to return all available GitHub tokens.
  - `count_response` V1CountResponse: Response to a list count request.
    - `count` integer: Number of objects matching the given list parameters.
  - `group_response` V1GroupResponse: Response to a list group request.
    - `groups` object: Map indexed by values of the fields specified in aggregation_paths, for example, {"[{"key":"meta.kind","value":"Project"}]": { "aggregation_count": { "count": 1649 } } }.
  - `list` V1ListGithubTokensResponseList
    - `objects` V1GithubToken[]
      - `spec` V1GithubTokenSpec
        - `token` string: The address fields of the tenant.
    - `response` V1ListResponse: Response to a list request.
      - `next_page_id` string: The UUID of last message retrieved.
      - `next_page_token` integer: Pagination token that can be used to retrieve the next page of results.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `4acd9fe15140`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference/changes/v1/github-tokens/get.md)

---

[API](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference.md) - [All operations](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/endorlabs/apis/endor-labs-rest-api-reference/revisions/9c1a64674369?raw)