---
title: "Get Auth Diagnostics Flow"
method: GET
path: "/api/admin/auth-diagnostics/flow/{auth_flow_id}"
tags: ["admin"]
---

# Get Auth Diagnostics Flow

`GET /api/admin/auth-diagnostics/flow/{auth_flow_id}`

## Request

- Base URL: `https://api.retirementlab.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.retirementlab.app/api/admin/auth-diagnostics/flow/{auth_flow_id}`
- Auth: HTTP bearer

Return the ordered stage/outcome/reason timeline for a single auth attempt.

This is the spec's primary diagnostic path: when an admin has an
``auth_flow_id`` from a user report or alert, this endpoint shows
exactly which auth stages ran and how each ended.

## Path parameters

- `auth_flow_id` string, required

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- AuthFlowTimelineResponse
  - `generated_at` string, required
  - `auth_flow_id` string, required
  - `event_count` integer, required
  - `first_event_at` string
  - `last_event_at` string
  - `providers` string[], required
  - `intents` string[], required
  - `outcomes` string[], required
  - `reason_codes` string[], required
  - `stages` string[], required
  - `user_ids` integer[], required
  - `anonymous_user_ids` integer[], required
  - `events` AuthFlowTimelineEvent[], required
    - `occurred_at` string
    - `stage` string
    - `outcome` string
    - `reason_code` string
    - `provider` string
    - `intent` string
    - `route` string
    - `method` string
    - `status_class` string
    - `status_code` integer
    - `deploy_sha` string
    - `user_id` integer
    - `anonymous_user_id` integer
    - `request_id` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/retirementlab/apis/income-simulator-api.md) · [All operations](https://skmtc.dev/retirementlab/apis/income-simulator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retirementlab/apis/income-simulator-api/revisions/b0f00a0333fd?raw)