---
title: "Analyzes state of a token and getting some data from it"
method: POST
path: "/realms/{realm}/protocol/openid-connect/token/introspect"
tags: ["token"]
---

# Analyzes state of a token and getting some data from it

`POST /realms/{realm}/protocol/openid-connect/token/introspect`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `Authorization`

Analyzes state of a token and getting some data from it

## Path parameters

- `realm` string, required

## Headers

- `Authorization` string, required

## Response `200`

OK

- DtoIntrospectTokenResult
  - `active` boolean
  - `aud` string[]
  - `auth_time` integer
  - `exp` integer
  - `iat` integer
  - `jti` string
  - `nbf` integer
  - `typ` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2024-04-30** `d9ec2b8f8a47`: 1 info
  - endpoint added
- **2024-03-06** `4009b08a3a5a`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/wissance/apis/wissance-ferrum-api/changes/realms/:realm/protocol/openid-connect/token/introspect/post.md)

---

[API](https://skmtc.dev/wissance/apis/wissance-ferrum-api.md) - [All operations](https://skmtc.dev/wissance/apis/wissance-ferrum-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wissance/apis/wissance-ferrum-api/revisions/45bad8274649?raw)