Token Info Endpoint

GET /oauth2/token/(string: token)

The token info endpoint returns information about an access token.

Example request:

GET /oauth2/token/2YotnFZFEjr1zCsicMWpAA HTTP/1.1
Accept: application/json

Example successful response:

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-cache
Pragma: no-cache

{
    "scopes": ["subscriptions", "suggestions", "favorites"],
    "token": "2YotnFZFEjr1zCsicMWpAA",
    "app": {
        "url": "http://gpodder.org/",
        "name": "gPodder",
        "client_id": "cab216c0509f4d60b227548674694b3b",
    },
    "created_at": "2015-05-22T17:19:51Z",
    "user": {
        "login": "bob",
    }
}

Example error response:

HTTP/1.1 404 Not Found
Content-Type: application/json
Cache-Control: no-cache
Pragma: no-cache

{
    "token": "d294f1f1a91933",
    "error": "Token does not exist."
}

Parameters:

• token – The token for which information should be retrieved

Response JSON Object:  

• scopes – List of scopes that this token can access
• token – The token for which information was requested
• app – Information about the app that requested the token
• app/url – The website of the URL
• app/name – A human-readable name of the app
• app/client_id – The app’s client_id
• created_at – The timestamp at which the token was created
• user – Information about the user that owns the token
• user/login – The username (login) of the user

Status Codes:

• 200 OK – the token exists and is still valid
• 404 Not Found – the token either expired or never existed