Platform API reference

Platform API · Authentication

get/v1/auth/step-upAuth

Get the session's step-up state

Whether sensitive actions are allowed right now (a second step, or the sign-in itself, in the last 10 minutes), until when, and how to step up. `methods`: `totp` / `email` / `webauthn` / `recovery_code` for an account with factors, `password` for one without, `reauthenticate` (sign in again) for one with neither.

Response · 200

active*boolean

True while the session completed a second step (or signed in) in the last 10 minutes.

valid_until*string · date-time

End of the current window, or null when not stepped up.

methods*array

How this session can step up. Open enum.

factors*array

The account's active factors to offer.

Example

Request

GET https://api.platform-auth.productcraft.co/v1/auth/step-up
Authorization: Bearer YOUR_TOKEN

Response

{
  "active": false,
  "valid_until": "2026-01-01T00:00:00.000Z",
  "methods": [
    "totp"
  ],
  "factors": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "type": {},
      "label": "string",
      "email_masked": "string"
    }
  ]
}