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

# Get events

`GET /api/v2/events`

List events.

## Query parameters

- `sort` string[]
- `filter` union — Filter schema for `event` list endpoints — pass a single condition or a logical group.
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
  - FilterEvent — Filter parameters for absence event types (time-off categories).
    - `status` union — Filter by active/archived status.
      - Status — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` Status — unresolved $ref
        - `not_contain` Status — unresolved $ref
        - `eq` Status — unresolved $ref
        - `contains` Status — unresolved $ref
    - `limitation_type` union — Filter by the limitation type applied to entitlement accrual.
      - LimitationType — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` LimitationType — unresolved $ref
        - `not_contain` LimitationType — unresolved $ref
        - `contains` LimitationType — unresolved $ref
        - `eq` LimitationType — unresolved $ref
    - `sync_personal_integrations` union — Filter by whether the event type syncs with personal calendar integrations.
      - SyncPersonalIntegrations — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` SyncPersonalIntegrations — unresolved $ref
        - `eq` SyncPersonalIntegrations — unresolved $ref
        - `contains` SyncPersonalIntegrations — unresolved $ref
        - `not_contain` SyncPersonalIntegrations — unresolved $ref
    - `half_day_bookings` union — Filter by whether the event type allows half-day bookings.
      - object — Filter using explicit operator syntax.
        - `contains` HalfDayBookings — unresolved $ref
        - `not_contain` HalfDayBookings — unresolved $ref
        - `eq` HalfDayBookings — unresolved $ref
        - `not_eq` HalfDayBookings — unresolved $ref
      - HalfDayBookings — unresolved $ref
    - `id` union — Filter by event type ID.
      - Id — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
    - `absence_type` union — Filter by absence type (e.g. vacation, sick leave).
      - AbsenceType — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` AbsenceType — unresolved $ref
        - `contains` AbsenceType — unresolved $ref
        - `not_contain` AbsenceType — unresolved $ref
        - `not_eq` AbsenceType — unresolved $ref
    - `name` union — Filter by the name of the absence category (event).
      - Name — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` Name — unresolved $ref
        - `contains` Name — unresolved $ref
        - `eq` Name — unresolved $ref
        - `not_contain` Name — unresolved $ref
    - `limited` union — Filter by whether the event type has an entitlement limit (true) or is unlimited (false).
      - object — Filter using explicit operator syntax.
        - `not_contain` Limited — unresolved $ref
        - `contains` Limited — unresolved $ref
        - `not_eq` Limited — unresolved $ref
        - `eq` Limited — unresolved $ref
      - Limited — unresolved $ref

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection event

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/7764b2b9fcc4/schema)