---
title: "Get Events"
method: GET
path: "/events"
tags: ["Events"]
---

# Get Events

`GET /events`

## Request

- Base URL: `https://production.trackstarhq.com`
- URL: `https://production.trackstarhq.com/events`
- Auth: none required

Returns a feed of events for your organization, newest first: failed
installs, connection lifecycle changes, sync activity, and schedule state
changes. Narrow the feed with the integration, connection, customer, event
type, and time filters. A start_date is required.

## Query parameters

- `integration_name` string, nullable
- `integration_type` string, nullable
- `connection_id` string, nullable
- `customer_id` string, nullable
- `type` 'install_failed' | 'connection_error' | 'schedule_stuck' | 'schedule_unstuck' | 'on_demand_sync_stuck' | 'connection_created' | 'connection_reinstalled' | 'connection_deleted' | 'connection_disabled' | 'connection_enabled' | 'schedule_paused' | 'schedule_unpaused' | 'on_demand_sync_started' | 'on_demand_sync_completed' | 'on_demand_sync_cancelled' | 'historical_sync_completed', nullable
- `start_date` string, date-time, required
- `end_date` string, date-time, nullable

## Headers

- `x-trackstar-api-key` string, required

## Response `200`

Successful response

- EventsResponseSchema
  - `data` Event[], required: The list of events, newest first.
    - `id` string, required: The event id.
    - `type` 'install_failed' | 'connection_error' | 'schedule_stuck' | 'schedule_unstuck' | 'on_demand_sync_stuck' | 'connection_created' | 'connection_reinstalled' | 'connection_deleted' | 'connection_disabled' | 'connection_enabled' | 'schedule_paused' | 'schedule_unpaused' | 'on_demand_sync_started' | 'on_demand_sync_completed' | 'on_demand_sync_cancelled' | 'historical_sync_completed', required: The event type.
    - `integration_name` string, required: The integration name.
    - `integration_type` string, required: The integration type.
    - `customer_id` string, nullable, required: Your identifier for the end customer, if any.
    - `connection_id` string, nullable, required: The connection the event belongs to, if any.
    - `message` string, nullable, required: A human-readable message, if the event has one.
    - `created_at` string, date-time, required: When the event occurred.
    - `additional_fields` unknown
  - `next_token` string, nullable, required: See [pagination](/how-to-guides/about-the-api#pagination) for more details.

## Other responses

- `422`: Validation error

## Changes

- **2026-11-03** `f9f948f2a7b3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trackstarhq/apis/trackstar-api/changes/events/get.md)

---

[API](https://skmtc.dev/trackstarhq/apis/trackstar-api.md) - [All operations](https://skmtc.dev/trackstarhq/apis/trackstar-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trackstarhq/apis/trackstar-api/revisions/08647f790594?raw)