---
title: "Introspect OAuth2 token"
method: POST
path: "/oauth2/introspect"
tags: ["OAuth2"]
---

# Introspect OAuth2 token

`POST /oauth2/introspect`

Verifies token validity and retrieves metadata. Returns active status, scope, expiration, and user information. Client authentication via authorization header or client credentials.

## Response `200`

Success

- OAuth2IntrospectResponse
  - `active` boolean, required — Whether the token is currently active
  - `scope` string — The space-separated list of scopes
  - `client_id` string, snowflake
  - `username` string — The username of the token owner
  - `token_type` string — The type of token
  - `exp` integer
  - `iat` integer
  - `sub` string, snowflake

## Other responses

- `400` — Bad Request - The request was malformed or contained invalid data
- `429` — Too Many Requests - You are being rate limited
- `500` — Internal Server Error - An unexpected error occurred

---

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