---
title: "POST /api/login/oauth/introspect"
method: POST
path: "/api/login/oauth/introspect"
---

# POST /api/login/oauth/introspect

`POST /api/login/oauth/introspect`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/login/oauth/introspect`
- Auth: none declared

The introspection endpoint is an OAuth 2.0 endpoint that takes a

## Request body `application/x-www-form-urlencoded`

- object
  - `token` string, required: access_token's value or refresh_token's value
  - `token_type_hint` string, required: the token type access_token or refresh_token

## Response `200`

The Response object

- ObjectIntrospectionResponse
  - `active` boolean
  - `aud` string[]
  - `client_id` string
  - `exp` integer
  - `iat` integer
  - `iss` string
  - `jti` string
  - `nbf` integer
  - `scope` string
  - `sub` string
  - `token_type` string
  - `username` string

## Other responses

- `400`: The Response object
- `401`: The Response object

## Changes

- **2022-07-01** `52cacbf3790a`: 2 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
- **2022-03-18** `3ce819e8c324`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/casdoor/apis/casdoor-restful-api/changes/api/login/oauth/introspect/post.md)

---

[API](https://skmtc.dev/casdoor/apis/casdoor-restful-api.md) - [All operations](https://skmtc.dev/casdoor/apis/casdoor-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/casdoor/apis/casdoor-restful-api/revisions/be9a5584b821?raw)