Skip to main content

​
Endpoint

GET https://auth.planetscale.com/oauth/token/info
Returns information about the currently authenticated access token, including whether it’s active, scopes, and expiration.

​
Authentication

This endpoint requires a valid OAuth access token in the Authorization header: 
Authorization: Bearer YOUR_ACCESS_TOKEN

​
Response

​
Success Response (200 OK) - Active Token

{
  "active": true,
  "scope": "read_user read_databases",
  "client_id": "pscale_app_abc123",
  "token_type": "Bearer",
  "exp": 1709078400,
  "iat": 1706486400,
  "sub": "user_xyz789"
}
​
active
boolean
Whether the token is currently active (not expired or revoked)
​
scope
string
Space-separated list of scopes granted to this token
​
client_id
string
The OAuth application’s client ID
​
token_type
string
Will always be “Bearer”
​
exp
integer
Unix timestamp when the token expires
​
iat
integer
Unix timestamp when the token was issued (created)
​
sub
string
Subject - the ID of the user who authorized the token

​
Success Response (200 OK) - Inactive Token

If the token is expired, revoked, or invalid: 
{
  "active": false
}

​
Example

curl -X GET https://auth.planetscale.com/oauth/token/info \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Use Cases

This endpoint is useful for:
  • Validating that a token is still active
  • Checking which scopes a token has access to
  • Determining when a token will expire
  • Identifying which user authorized the token
  • Token introspection for security auditing