Skip to main content

Validate a user token​

This endpoint validates a SlashID user token. The response indicates whether the token is valid and its expiration time if so. If the token is not valid, the reason is returned.

Header Parameters
  • SlashID-SdkVersion string

    Optional SDK version

    Example: 1.4.1
Request Body required
  • token string required

    A JWT token. Can be either a User token (UserTokenText) or a Token Container (TokenContainerText)

Responses

OK

Schema
  • meta object
  • pagination object
  • limit integer
  • offset integer
  • total_count int64
  • cursor_pagination object

    Cursors are opaque. Follow the tokens the server returns; never construct, parse or modify one.

  • limit integer
  • next_cursor string

    Opaque token addressing the next page. Absent on the last page.

  • prev_cursor string

    Opaque token addressing the previous page. Absent on the first page.

  • last_cursor string

    Opaque token addressing the final page directly, so a client can jump to the end without a total count.

  • total_count int64

    Total number of matching items. Returned on the FIRST page only; clients cache it for the remainder of the walk.

  • errors object[]
  • httpcode integer
  • message string
  • result object
  • valid boolean

    True if token is genuine and has not expired yet, false otherwise.

  • invalidity_reason string

    Possible values: [invalid_token_content, expired, invalid_issuer, not_enough_factors, person_not_active]

    If the token is invalid, this field contains the reason.

  • expires_in_seconds integer

    JWT token validity. This value is not present if the token is not valid (valid field == false).

  • expires_at date-time

    Token expiration time in UTC. This value is not present if token is not valid (valid field == false) or expired.