---
title: "Get auth connection event timeline"
method: GET
path: "/auth/connections/{id}/timeline"
tags: ["Managed Auth"]
---

# Get auth connection event timeline

`GET /auth/connections/{id}/timeline`

Returns a chronological timeline of events for an auth connection —
login attempts, automatic re-auth attempts, and health checks. Events
are returned newest-first.

## Path parameters

- `id` string, required

## Query parameters

- `type` 'login' | 'reauth' | 'health_check'
- `limit` integer
- `offset` integer

## Response `200`

Event timeline for the auth connection

- ManagedAuthTimelineEvent[]
  - `type` 'login' | 'reauth' | 'health_check', required — The kind of event. "login" and "reauth" are authentication attempts; "health_check" is a periodic session-validity check.
  - `id` string, required — Identifier of the underlying login/reauth session or health check.
  - `timestamp` string, date-time, required — When the event occurred.
  - `status` 'IN_PROGRESS' | 'SUCCESS' | 'EXPIRED' | 'CANCELED' | 'FAILED' | 'AUTHENTICATED' | 'NEEDS_AUTH', required — Outcome of the event. For login/reauth events this is the flow status (IN_PROGRESS, SUCCESS, EXPIRED, CANCELED, FAILED). For health_check events it is the observed session state (AUTHENTICATED, NEEDS_AUTH).
  - `previous_status` 'AUTHENTICATED' | 'NEEDS_AUTH' — The session state observed before this event. Present for health_check events that recorded a prior state.
  - `step` 'INITIALIZED' | 'DISCOVERING' | 'AWAITING_INPUT' | 'AWAITING_EXTERNAL_ACTION' | 'AWAITING_HUMAN_INTERVENTION' | 'SUBMITTING' | 'COMPLETED' | 'EXPIRED' — The step the flow reached. Present for login/reauth events.
  - `error_code` string — Machine-readable error code. Present when a login/reauth event failed.
  - `error_message` string — Human-readable error message. Present when a login/reauth event failed.
  - `website_error` string — Visible error message from the website (e.g., 'Incorrect password'). Present when the website displayed an error during the attempt.
  - `browser_session_id` string — Browser session that produced the event, if one was created.
  - `replay_id` string — Replay recording ID for the event's browser session, if session recording was enabled.
  - `telemetry_captured` boolean — Whether browser telemetry capture started for this event's browser session.
  - `updated_at` string, date-time — When the event was last updated. Present for login/reauth events.

## Other responses

- `401` — Unauthorized – missing or invalid authorization token
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/kernel/apis/kernel-api.md) · [All operations](https://skmtc.net/kernel/apis/kernel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/kernel-api/versions/9e8ce9fcf5e1/schema)