Get step-up action status

GET

/auth/step-up/actions/{actionId}

Code sample: Shell / cURL

curl --request GET \
  --url https://auth.example.com/auth/step-up/actions/example

Return no-store status for a step-up action.

Parameters

Path Parameters

actionId

required

string

Responses

200

Step-up action status.

Media type application/json

object

action_id

string

status

string

preferred_method

object

category

string

method

string

expires_at

string

expires_at_unix

integer format: int64

next_action

Any of:

string

string

null

null

Example

{
  "action_id": "step_123",
  "status": "pending",
  "preferred_method": {
    "category": "otp",
    "method": "email_otp"
  },
  "expires_at": "2026-02-01T00:05:00.000Z",
  "expires_at_unix": 1770000300,
  "next_action": "verify_code"
}

default

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}