---
title: "Fetch event set"
method: GET
path: "/event_sets/{id}"
tags: ["Event sets"]
---

# Fetch event set

`GET /event_sets/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `id` integer, required — The ID of the event set
  - `created_at` string, date-time, required — When the event set was created
  - `status` 'in_progress' | 'finished' | 'failed', required — The status of the event set
  - `interval` string, required — Filter by the creation date of the event. The timestamp is expected to be in ISO8601 format. The interval defaults to the past 90 days. The interval cannot be wider than 90 days. Supported patterns: - Start/End, eg. `2019-03-09T13:00:00Z/2019-03-10T15:30:00Z` - Start/Duration, eg. `2019-03-09T13:00:00Z/P1Y2M10D` - Duration/End, eg. `PT2H30M/2019-03-09T15:30:00Z` Duration on its own (eg. `P1Y2MT1H`) is not supported.
  - `event_actor_id` integer, nullable, required
  - `event_actor_type` string, nullable, required
  - `event_authenticated_by_id` integer, nullable, required
  - `event_authenticated_by_type` string, nullable, required
  - `event_object_id` integer, nullable, required
  - `event_object_type` string, nullable, required
  - `event_place_id` integer, nullable, required — The place ID to filter events by. Only one of event_place_id and place_id can be set.
  - `event_success` boolean, nullable, required
  - `event_sequence` string, nullable, required — Multiple sequences are separated with `,`
  - `event_type` string, nullable, required — Multiple types are separated with `,`
  - `event_uuid` string, nullable, required — Multiple UUIDs are separated with `,`
  - `events` object[] — The events of the event. Is not included if `status` is `in_progress`.
    - `uuid` string, uuid, required — The UUID of the event
    - `type` string, required — The type of the event
    - `actor_type` 'null' | 'GroupLink' | 'MarketplaceInstallation' | 'User' | 'Guest', nullable, required — The type of the actor of the event
    - `actor_id` integer, nullable, required — The ID of the actor of the event
    - `actor_name` string, nullable, required — The name of the actor of the event
    - `actor_email` string, nullable, required — The email of the actor of the event
    - `authenticated_by_type` 'null' | 'ApplePassInstance' | 'Card' | 'GroupLink' | 'Login' | 'OauthAccessToken' | 'AccessKey', nullable, required — The type of the credential of the event
    - `authenticated_by_id` integer, nullable, required — The ID of the credential
    - `authorized_by_type` string, nullable, required
    - `authorized_by_id` integer, nullable, required
    - `authorized_by_role_id` string, nullable, required
    - `object_type` string, required — The type of the object of the event
    - `object_id` integer, required — The ID of the object of the event
    - `object_name` string, required — The name of the object of the event
    - `object` object — The object of the event
    - `action` string, required — The action of the event
    - `created_at` string, date-time, required — When the event was created
    - `message` string, nullable, required — The string representation of the event
    - `success` boolean, required — Whether the action was successful
    - `code` string, nullable, required — The code of the event
    - `sequence` string, required — The sequence used to group related events part of the same action
    - `organization_id` integer, required — The organization ID of the event
    - `place_id` integer, nullable, required — The place ID of the event
    - `error_code` string, nullable, required — The error code of the event
    - `error_message` string, nullable, required — The error message of the event
    - `details` object, required
    - `via` object, required
  - `cursor` string, nullable, required — The cursor of the event set. Will be `null` if `status` is `in_progress` or if there are no more events.
  - `place_id` integer, nullable, required — The place ID of a place-scoped event set. Only one of place_id and event_place_id can be set.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `503` — Service Unavailable

---

[API](https://skmtc.dev/kisi/apis/kisi-api.md) · [All operations](https://skmtc.dev/kisi/apis/kisi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kisi/kisi-api/revisions/998700ffff5a/schema)