---
title: "Introspect OAuth 2.0 Token"
method: POST
path: "/v1/oauth/introspect"
tags: ["OAuth"]
---

# Introspect OAuth 2.0 Token

`POST /v1/oauth/introspect`

Introspect an OAuth 2.0 token for an API client.

## Response `200`

Returns details about an existing token and its expiration times. If an nonexistent token is sent in the request, the response returns that it is inactive.

- OAuthTokenIntrospectResponseBody — Details about the OAuth token.
  - `access_token` string, required — The access token used to authorize access to the Voucherify API.
  - `client_id` string, required — Unique client identifier, assigned by Voucherify, for OAuth.
  - `expires_at` integer, required — Timestamp in seconds in the Unix format indicating when the token expires.
  - `expires_in` integer, required — Number of seconds left until the token expires.
  - `scope` string, required — Defines the scope of possible actions that can be done with the OAuth token. The `api` scope allows using the server-side API. The `client_api` scope allows using the whole client-side API. Possible values: `api`, `assets`, `async-actions`, `campaigns`, `categories`, `client_api`, `client_consents`, `client_customers`, `client_events`, `client_promotions`, `client_publish`, `client_qualifications`, `client_redeem`, `client_redemptions`, `client_validate`, `client_validations`, `client_vouchers`, `consents`, `customers`, `events`, `exports`, `locations`, `loyalties`, `metadata-schemas`, `orders`, `product-collections`, `products`, `promotions`, `publications`, `qualifications`, `redemptions`, `referrals`, `rewards`, `segments`, `skus`, `task-results`, `templates`, `trash-bin`, `validation-rules-assignments`, `validation-rules`, `validations`, `vouchers`.
  - `token_type` 'Bearer', required — Type of the token. Use the value as the header prefix for authorization.
  - `active` boolean, required — Determines if the token is active. Nonexistent tokens are also marked as inactive.

## Other responses

- `400` — Returns an error if an invalid request body is provided.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)