Inspect human guest lifecycle progress.

GET

/api/admin/account-lifecycle/guests

Code sample: Shell / cURL

curl --request GET \
  --url 'https://auth.example.com/api/admin/account-lifecycle/guests?limit=100' \
  --header 'Authorization: Bearer <token>'

Requires tenant-scoped account-lifecycle settings read permission. Includes active, upgrading, registered, deleting and deleted records. Cursors expire after 15 minutes. Records are live observations, not a transactional snapshot. Maintenance observations may lag and expire after 30 days; null means no retained valid observation. Malformed optional observations are omitted without hiding the authoritative lifecycle record. All timestamps are Unix seconds. This endpoint never modifies accounts.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Query Parameters

limit

integer

default: 100 >= 1 <= 100

cursor

string

Responses

200

Bounded tenant-scoped lifecycle page.

Media type application/json

object

next_cursor

required

string | null

observed_at

required

integer

items

required

Array<object>

object

user_id

required

string

phase

required

string

Allowed values: active upgrading registered deleting deleted

created_at

required

integer

deletion_due_at

required

integer | null

upgrade_hold_until

required

integer | null

upgraded_at

required

integer | null

deleted_at

required

integer | null

updated_at

required

integer

overdue_seconds

required

Seconds past the effective deletion deadline including the upgrade hold; zero for non-deletion phases.

integer

maintenance

required

object

state

required

string

Allowed values: processing pending completed retrying

attempted_at

required

integer

Example

{
  "items": [
    {
      "phase": "active",
      "maintenance": {
        "state": "processing"
      }
    }
  ]
}

400

Invalid limit.

403

Missing tenant-scoped settings permission.

409

Cursor missing, malformed, expired or issued for another tenant.

503

Lifecycle inspection temporarily unavailable.