Sign in

v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Connection Tokens

Check connection token

This endpoint lets you check the status of a connection token. To be able to check a connection token of a user, you need to have WRITE access on that user.

get/connection/check_token

Query parameters

user_idstring required

User id

Example:5309c3a237bbc544d8e26737

User id

tokenstring required
Example:\xaf3e8951c1f4c42f9cc53116b3fc855bd44bce01cf27604b

User connection token

Response

OK

tokenstring

New connection token

expiration_datestring date-time

Expiration date of the token

generated_bystring

Id of the user that created the token

creation_datestring date-time

Creation date of the token

consumption_datestring date-time

Date the token was consumed, ie. used to log in

status'revoked' | 'consumed' | 'expired' | 'valid'

Status of the token:

  • valid means it can be use to log in
  • consumed means it has been used to log in
  • revoked means it has been revoked before being used or expired
  • expired means it has expired before being used

Example response

{
  "token": "\\xaf3e8951c1f4c42f9cc53116b3fc855bd44bce01cf27604b",
  "expiration_date": "2019-08-02T19:15:54.256000+02:00",
  "generated_by": "5309c3a237bbc544d8e26737",
  "creation_date": "2019-08-01T19:15:54.256000+02:00",
  "consumption_date": "2019-08-01T23:15:54.256000+02:00",
  "status": "consumed"
}