Retrieve Token Information

Overview

This endpoint retrieves detailed information about a specific OAuth token, including roles, scopes, expiration, and creation timestamp. It is commonly used for validation, debugging, or auditing purposes.

The access token is not returned in this API call for security reasons. If needed, revoke the access token and create a new one.

Endpoint Details

DefinitionDescription
Endpointhttps://api.paas.sandbox.co.passportfintech.com/v1/iam/oauth/tokens/:token_id
MethodGET
HeadersAccept-Language, Content-Length, Content-Type: application/json, Authorization
AuthenticationAccess Token (Bearer Token)

Request Body

This endpoint does not require a request body.

Example Request

JSON
Copy

Response

  • HTTP Status Code 200 OK.

Example of Response

JSON
Copy

Common Errors and Handling

HTTP Status CodeMeaningDescription
400Bad RequestInvalid token ID format or missing parameters
401UnauthorizedBearer token missing, expired, or does not include the required scope
403ForbiddenAuthenticated user lacks permission to view token details
404Not FoundToken ID not found in the IAM system
500Internal Server ErrorUnexpected error. Retry or contact support if issue persists

Best Practices

  • Use this endpoint for auditing and debugging token permissions.
  • Ensure proper handling of sensitive data: never log raw tokens in plaintext.
  • Store theexpires_in value to track token lifetime and refresh before expiration.
  • Implement monitoring for401/403 responses to detect when credentials need rotation.
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Next to read:
List Token Information

Contactar Passport

On This Page
Retrieve Token InformationOverviewEndpoint DetailsRequest BodyExample RequestResponseExample of ResponseCommon Errors and HandlingBest Practices