---
title: "Get Derived Events"
method: GET
path: "/derived_events"
---

# Get Derived Events

`GET /derived_events`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/derived_events`
- Auth: none declared

## Query parameters

- `limit` integer
- `page` integer
- `filters[]` string[], nullable
- `tz` string, nullable
- `start_of_week` 0 | 1

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable
- `X-Browser-Time-Zone` string, nullable

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- ListDerivedEventsSchema
  - `derived_events` DerivedEventSchema[]
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `event_name` string, required
    - `filters` AllOfWhereFilters, required
      - `all_of` OrWhereFilters[]
        - `or_filters` WhereFilter[]
          - `property` union, required
            - string
            - union
              - …
          - `operator` '=' | '>' | '<' | '>=' | '<=' | '!=' | 'includes' | 'includes_any_contains' | 'not_includes' | 'contains' | 'not_contains' | 'is_set' | 'is_not_set', required
          - `value` union, required
            - boolean
            - integer
            - number
            - string
            - string[]
    - `creator` AccountSchema
      - `id` integer, required
      - `email` string, required
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `profile_picture_url` string, nullable
    - `created_at` string, date-time, nullable
    - `is_editable` boolean, required
  - `count` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-13** `118b0bdc2a6a`: 1 breaking, 1 info
  - added `#/components/schemas/ProfileCityProperty, #/components/schemas/ProfileStateProperty, #/components/schemas/ProfileCountryCodeProperty` to the `derived_events/items/filters/all_of/items/or_filters/items/property/anyOf[subschema #2]/` response property `oneOf` list for the response status `200`
  - added `$city, $country_code, $state` discriminator mapping keys to the `derived_events/items/filters/all_of/items/or_filters/items/property/anyOf[subschema #2]/` response property for the response status `200`
- **2026-09-29** `31dc8dde8194`: 1 breaking, 1 info
  - added `#/components/schemas/TimeToFirstOrderProperty` to the `derived_events/items/filters/all_of/items/or_filters/items/property/anyOf[subschema #2]/` response property `oneOf` list for the response status `200`
  - added `time_to_first_order` discriminator mapping keys to the `derived_events/items/filters/all_of/items/or_filters/items/property/anyOf[subschema #2]/` response property for the response status `200`

[Operation history](https://skmtc.dev/runconverge/apis/runconverge-api/changes/derived_events/get.md)

---

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