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

# Get all events

`GET /v1/events`

This endpoint returns the details of all events (all event types: webinar, field events, events) created by your Zuddl organization. You can use query parameters to filter and sort out the list, and pagination to show the list in an order.

Required API key scopes: `READ`

## Query parameters

- `filter` string
- `sort` string
- `page` number
- `size` number

## Response `200`

List of events retrieved successfully

- OrgEventsAppDomainApiProductEventEventListPage
  - `pagination` OrgEventsAppDomainApiProductDtosPageResponsePagination
    - `next` string, uri — URI of the next page. Also indicates the presence of a next page.
    - `current` string, uri — URI of the current page.
    - `previous` string, uri — URI of the previous page. Also indicates the presence of a previous page.
  - `data` OrgEventsAppDomainApiProductEventEvent[]
    - `kind` string
    - `url` string, uri
    - `id` string, uuid — ID of the event
    - `organizationId` string, uuid — ID of the organization
    - `name` string — Name of the event
    - `teamName` string — TeamName of the event
    - `description` string — Description of the event
    - `identifier` string — Identifier of the event
    - `startDate` string, date-time — startDate of the event
    - `endDate` string, date-time — endDate of the event
    - `timezone` string — Timezone of the event
    - `status` 'UPCOMING' | 'ONGOING' | 'CANCELED' | 'COMPLETED' — Status of the event
    - `type` 'EVENT' | 'FIELD_EVENT' | 'WEBINAR' | 'THIRD_PARTY_EVENT' — Type of the event
    - `eventFormat` 'VIRTUAL' | 'IN_PERSON' | 'HYBRID' — Format of the event
    - `websiteUrl` string — websiteUrl of the event
    - `parentEventId` string, uuid — parentEventId of the event
    - `location` OrgEventsAppDomainApiProductEventEventEventLocation — location of the event
      - `venue` string — venue of the event
      - `address` OrgEventsAppDomainApiProductEventEventEventLocationEventLocationAddress — address of the event
        - `address` string — venue of the event
        - `addressLine2` string — addressLine2 of the event
        - `city` string — city of the event
        - `stateProvince` string — stateProvince of the event
        - `postalCode` string — postalCode of the event
        - `country` string — country of the event
      - `coordinates` OrgEventsAppDomainApiProductEventEventEventLocationCoordinates — coordinates of the event
        - `latitude` string — latitude of the event address
        - `longitude` string — longitude of the event
      - `mapUrl` string — mapUrl of the event
    - `virtualEventUrl` string — virtualEventUrl of the event
    - `createdAt` string, date-time — createdAt of the event
    - `createdBy` string, uuid — createdBy of the event
    - `updatedAt` string, date-time — updatedAt of the event
    - `updatedBy` string, uuid — updatedBy of the event
    - `tags` OrgEventsAppDomainEventTagsOrganizationTagDTOBase[] — Tags associated with the event
      - `id` string, required — Unique identifier for the tag
      - `name` string, required — Name of the tag
      - `color` string — Tag's own color or inherited from category
      - `categoryId` string — Category ID if tag belongs to a category
      - `categoryName` string — Category name
      - `categoryColor` string — Category color
      - `lastAppliedAt` string, date-time — Last time tag was applied
      - `usageCount` integer — Number of times tag has been used

## Other responses

- `400` — Invalid org ID supplied
- `401` — Unauthorized access to org
- `404` — Organization not found

---

[API](https://skmtc.net/zuddl/apis/zuddl-webhook-documentation.md) · [All operations](https://skmtc.net/zuddl/apis/zuddl-webhook-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuddl/zuddl-webhook-documentation/revisions/571c1d41e62a/schema)