---
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`

## Request

- Base URL: `https://client-tracking.truelayer-sandbox.com`
- URL: `https://client-tracking.truelayer-sandbox.com/v1/tracked-events`
- Auth: HTTP bearer

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 reauthentication. 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.dev/truelayer/apis/client-tracking-api.md) - [All operations](https://skmtc.dev/truelayer/apis/client-tracking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/client-tracking-api/revisions/300e1f38aa00?raw)