OAuth Access Tokens

Verify an OAuth Access Token

Changed on
post/oauth_applications/access_tokens/verify

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/oauth_applications/access_tokens/verify
  • Auth: HTTP bearer

Request body

access_tokenstring

The access token to verify.

secretstring

The access token to verify. This is deprecated, use access_token instead.

Example request

{
  "access_token": "XXXXXXXXXXXXXX",
  "secret": "XXXXXXXXXXXXXX"
}

Response

200 OK

OR

Example response

{
  "object": "clerk_idp_oauth_access_token",
  "id": "oat_0ef5a7a33d87ed87ee7954c845d80450",
  "client_id": "client_2xhFjEI5X2qWRvtV13BzSj8H6Dk",
  "subject": "user_2xhFjEI5X2qWRvtV13BzSj8H6Dk",
  "scopes": [
    "read",
    "write"
  ],
  "aud": [
    "https://api.example.com"
  ],
  "act": {
    "iss": "https://clerk.example.com",
    "sub": "client_2xhFjEI5X2qWRvtV13BzSj8H6Dk",
    "act": {
      "iss": "https://clerk.example.com",
      "sub": "client_3yiGkFJ6Y3rXSwuW24CaTk9I7El"
    }
  },
  "revocation_reason": "Revoked by user",
  "expiration": 1716883200,
  "created_at": 1716883200,
  "updated_at": 1716883200
}

Changes

  • 2025-11-107db12d6a9b2aRevision changes
    • info

      added the optional property / to the response with the status

  • 2025-11-101f66c253acacRevision changes
    • info

      added the optional property / to the response with the status