---
title: "Get tracked events from a specific authorization flow."
method: GET
path: "/v1/tracked-events"
tags: ["Tracked Events"]
---

# Get tracked events from a specific authorization flow.

`GET /v1/tracked-events`

Get all tracked events that happened in a specific authorization flow/session associated with a `tracking_id`. The events are stored for a period of 60 days.

## Query parameters

- `tracking_id` string, required

## Response `200`

Successful response returns the list of tracked events in the `results` field.

- TrackedEventResponse
  - `name` 'dialog_started' | 'provider_selected' | 'consent_granted' | 'provider_auth_started' | 'provider_authorized' | 'code_exchanged', required — Name of the specific event.
  - `time` string, required — Specific time when the event was recorded.
  - `flow_id` string — Identifier to indicate which authorization flow/session this event was tracked.
  - `credentials_id` string — Identifier of the credentials.
  - `consent_id` string — Identifier of the user consent.
  - `reauth` boolean — Indicates this event is part of a reauth. Authorization flow started using the `/reauth` endpoint.
  - `provider_id` string — Identifier of the selected provider.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/truelayer/apis/authentication-server.md) · [All operations](https://skmtc.net/truelayer/apis/authentication-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truelayer/authentication-server/revisions/5f6051515b2c/schema)