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

# Get Events

`GET /api/events`

Lists audit events for the caller's organization.

Results are paginated. If more events are available, the response includes
`pagination.next_page_token`; pass that token back unchanged to continue from
the last item you received.

Filter by event type using the `event_type` query parameter. Pass one of the
identifiers returned by [`GET /api/events_types`](../../api-reference/events/get-types) to
narrow results to a specific category of activity.

> 📘 Events reflect audit activity scoped to the caller's organization.
> The log captures both user-initiated and API-initiated actions.

## Query parameters

- `organization_id` string, uuid, nullable — Organization to list events for. Only used by system callers; normal and partner callers are always scoped to their own organization.
- `type` string — Filter to a single event type. Use GET /api/events_types to list valid values.
- `starting_after` string, date-time — Return events created strictly after this timestamp.
- `ending_before` string, date-time — Return events created strictly before this timestamp.
- `limit` integer — Maximum number of events to return. Default 10, maximum 100.

## Headers

- `X-Polytomic-Version` string

## Response `200`

OK

- EventsEnvelope
  - `data` Event[], nullable
    - `created_at` string, date-time — Timestamp the event was emitted.
    - `event` union
      - object
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
        - `target_connection_id` string, uuid
      - object
        - `deleted_records` string[], nullable
        - `error_count` integer
        - `errored_records` string[], nullable
        - `execution_id` string, uuid
        - `inserted_count` integer
        - `inserted_records` string[], nullable
        - `logs_url` string — Endpoint returning the index of record logs produced by this execution.
        - `organization_id` string, uuid
        - `record_count` integer
        - `schedule` EventingSyncSchedule
          - `frequency` string
        - `status` 'created' | 'scheduled' | 'queued' | 'waiting' | 'running' | 'processing' | 'canceling' | 'canceled' | 'completed' | 'failed' | 'interrupted'
        - `sync_id` string, uuid
        - `sync_name` string
        - `target_connection_id` string, uuid
        - `total_records` string[], nullable
        - `trigger` string
        - `updated_count` integer
        - `updated_records` string[], nullable
        - `upserted_count` integer
        - `warning_count` integer
        - `warnings` string[], nullable
      - object
        - `error` string
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
        - `target_connection_id` string, uuid
      - object
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `status` 'created' | 'scheduled' | 'queued' | 'waiting' | 'running' | 'processing' | 'canceling' | 'canceled' | 'completed' | 'failed' | 'interrupted'
        - `sync_id` string, uuid
        - `sync_name` string
        - `target_connection_id` string, uuid
      - object
        - `error` string
        - `execution_id` string, uuid
        - `number_of_errors` integer
        - `number_of_warnings` integer
        - `organization_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
        - `target_connection_id` string, uuid
      - object
        - `destination_connection_id` string, uuid
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `source_connection_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
      - object
        - `destination_connection_id` string, uuid
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `schedule` EventingBulkSyncSchedule
          - `frequency` string
          - `id` string, uuid
        - `source_connection_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
        - `trigger_source` string
      - object
        - `destination_connection_id` string, uuid
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `source_connection_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
      - object
        - `destination_connection_id` string, uuid
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `schedule` EventingBulkSyncSchedule
          - `frequency` string
          - `id` string, uuid
        - `source_connection_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
        - `trigger_source` string
      - object
        - `destination_connection_id` string, uuid
        - `error` string
        - `execution_id` string, uuid
        - `organization_id` string, uuid
        - `schedule` EventingBulkSyncSchedule
          - `frequency` string
          - `id` string, uuid
        - `source_connection_id` string, uuid
        - `sync_id` string, uuid
        - `sync_name` string
        - `trigger_source` string
    - `id` string, uuid — Unique identifier of the event.
    - `organization_id` string, uuid — Organization the event belongs to.
    - `type` string — Event type identifier.

## Other responses

- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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