---
title: "Show Token"
method: GET
path: "/api/v2/oauth/tokens/{oauth_token_id}"
tags: ["OAuth Tokens"]
---

# Show Token

`GET /api/v2/oauth/tokens/{oauth_token_id}`

Returns the properties of the specified token. For security reasons, only the first 10 characters of the access token are included.

In the first endpoint, `id` is a token id, not the full token.

In the second endpoint, include an `Authorization: Bearer` header with the full token to get its associated properties. Example:

```sh
curl https://{subdomain}.zendesk.com/api/v2/oauth/tokens/current.json \
  -H 'Authorization: Bearer ${authToken}' \
  -v -u {email_address}/token:{api_token}
```

#### Allowed for

* Admins, Agents, End Users

## Response `200`

Success response

- OAuthTokenResponse
  - `token` OauthTokenObject
    - `client_id` integer — The id of the client this token belongs to
    - `created_at` string, date-time — The time the token was created
    - `expires_at` string, date-time — The time the token will expire
    - `id` integer — Automatically assigned upon creation
    - `refresh_token` string — The refresh token, if generated
    - `refresh_token_expires_at` string, date-time — The time the refresh token will expire
    - `scopes` string[] — An array of the valid scopes for this token. See [Scopes](#scopes) below
    - `token` string — The access token
    - `url` string — The API url of this record
    - `used_at` string, date-time — The latest time this token was used for authentication
    - `user_id` integer — The id of the user this token authenticates as

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)