Skip to main content
POST
/
v1
/
oauth
/
introspect
TypeScript SDK
import { Client } from "@notionhq/client"

const notion = new Client()

const response = await notion.oauth.introspect({
  client_id: process.env.OAUTH_CLIENT_ID,
  client_secret: process.env.OAUTH_CLIENT_SECRET,
  token: "access_token_to_introspect"
})
{
  "active": true,
  "scope": "<string>",
  "iat": 123,
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2025-09-03.

Available options:
2025-09-03

Body

application/json
token
string
required

Response

active
boolean
required
scope
string
iat
integer
request_id
string<uuid>