Token Check

Introduction

This call can be used to verify the validity of an OAuth 2.0 token. The Token Check endpoint allows retrieving information about an Access Token and checking whether it is still valid.

Status Codes

The following table shows the possible status codes that can be returned when calling the Token Check endpoint:

Status CodeDescription
200 OKThe request was successful and the token validity is returned as a Boolean ("active") in the key "active".
400 Bad RequestThe request was not made with all necessary parameters.
401 UnauthorizedAuthentication with client_id and client_secret was not successful.

Note

It is important to note that a token can be invalidated at any time by actions taken by the user or HIN. The information returned by the Token Check endpoint is valid at the exact time of the query. It is therefore advisable to regularly check the token to ensure it is still valid.