---
title: "Query Oauth Tokens"
method: GET
path: "/oauth"
tags: ["OauthToken"]
---

# Query Oauth Tokens

`GET /oauth`

Used to retrieve the Oauth Tokens for the given organization

## Query parameters

- `organization_id` string
- `token_type` string
- `limit` integer
- `cursor` string

## Response `200`

The query result

- OauthTokenQueryResult
  - `oauth_tokens` OauthToken[] — All Oauth Tokens that matched the query
    - `id` string — The ID of the Oauth Token
    - `created_time` integer — Time at which the organization Oauth Token was created
    - `created_by_id` string — The ID of the user who created this OAuth token
    - `last_updated_time` integer — Time at which the organization Oauth Token was last updated
    - `last_updated_by_id` string — The ID of the user who last updated this OAuth token
    - `organization_id` string — The ID of the organization associated with this Oauth Token
    - `token_type` 'segment' | 'slack' | 'jira' — Type of token
    - `name` string — Friendly name for this Oauth Token
    - `access_token` string — The Oauth Token value
    - `scope` string — The Oauth Token scope
    - `refresh_token` string — The refresh token value
    - `expires_in` integer — The Oauth Token expiration value
    - `raw_response` string — The raw access token result from the issuer
    - `tags` Tag[] — Free text tags associated with this entity
      - `name` string, required — tag name
      - `values` string[]
  - `cursor` string — Cursor used for pagination

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Organization not found
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)