Get token information
Returns information about the current access token being used for authentication.
This endpoint provides metadata about the access token including the resource owner,
account, scopes, and expiration.
Authentication
Requires a valid OAuth2 access token in the Authorization header.
/oauth/token/info
Authentication
This endpoint requires authentication:
Use an OAuth 2.0 access token in the Authorization header. This is the recommended authentication method for all integrations. OAuth provides automatic token expiration, granular permission scopes, detailed usage tracking, and per-integration revocation. Learn how to obtain an access token.
Header Format:
Authorization: Bearer YOUR_ACCESS_TOKEN
Responses
Token information retrieved successfully
Response Fields
resource_owner_id
integer
required
ID of the user (resource owner) who authorized this token
eg. 12345
account_id
string
Hashid of the account associated with the resource owner
eg. abc123xyz
scope
array<string>
required
Array of OAuth scopes granted to this token
eg. ["account.person.readonly", "account.channel.readonly"]
expires_in
integer
required
Number of seconds until the token expires
eg. 7200
application
object
Show child attributes
uid
string
eg. abc123def456
Unique identifier of the OAuth application
created_at
integer
required
Unix timestamp when the token was created
eg. 1704067200
Unauthorized - Invalid or missing access token
Response Fields
error
string
eg. invalid_token
error_description
string
eg. The access token is invalid or has expired