Verify Clerk OAuth access token

Verify an OAuth access token issued by a connected Clerk application.

← All Clerk endpoints · Capability overview

POST/v1/clerk/oauth-applications/access-tokens/verify

https://api.vee3.io/v1/clerk/oauth-applications/access-tokens/verify

5 tokens

Verify an OAuth access token issued by a connected Clerk application.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

clerk.verify_oauth_access_token

Parameters2 fields

clerk_instance_idstringOptional

Clerk instance id (ins_...) from clerk.get_connected_accounts. Omit to use the default connected account.

access_tokenstringRequired

OAuth access token to verify.

Response10 fields

oauth_access_tokenobject

9 fields

Verification result from the Clerk Backend API.

objectstring

Object type when the token is active (e.g. "clerk_idp_oauth_access_token").

idstring

OAuth access token id (oat_...) when the token is active.

client_idstring

OAuth client id that issued the access token.

subjectstring

Authenticated user id (user_...) when the token is active.

scopesstring[]

Scopes granted to the access token.

revokedboolean

Whether the access token has been revoked.

expiredboolean

Whether the access token is expired.

expirationinteger

Expiration timestamp in seconds when the token is active.

activeboolean

False when a JWT-formatted token is not active (e.g. expired).

HTTP errors: clerk_connection_required, clerk_connection_not_found, clerk_connection_invalid, validation_error, unauthorized, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/clerk/oauth-applications/access-tokens/verify"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "access_token": "oat_example_access_token"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses2 examples

200Active OAuth access token verification result.

active_oauth_access_token.json

{
  "oauth_access_token": {
    "object": "clerk_idp_oauth_access_token",
    "id": "oat_2abc123",
    "client_id": "client_2abc123",
    "subject": "user_2abc123",
    "scopes": [
      "profile",
      "email"
    ],
    "revoked": false,
    "expired": false,
    "expiration": 1716883200
  }
}

200Unknown, invalid, or inactive OAuth access token.

inactive_oauth_access_token.json

{
  "oauth_access_token": {
    "active": false
  }
}