---
title: "Token introspection"
method: POST
path: "/oauth/introspect"
tags: ["OAuth Protocol"]
---

# Token introspection

`POST /oauth/introspect`

Introspect an OAuth access token to check its validity and metadata

## Request body

- IntrospectRequest
  - `token` string, required — The token to introspect

## Response `200`

Introspection response

- IntrospectResponse
  - `active` boolean, required — Whether the token is active
  - `scope` string — Space-separated list of scopes
  - `client_id` string — Client identifier
  - `exp` integer — Expiration timestamp
  - `iat` integer — Issued at timestamp
  - `iss` string — Issuer
  - `aud` string — Audience

## Other responses

- `400` — Invalid request
- `401` — Invalid client credentials

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)