---
title: "GET a collection of events."
method: GET
path: "/events"
tags: ["Events"]
---

# GET a collection of events.

`GET /events`

Retrieve a collection of events with event details.

## Query parameters

- `event_status` string
- `search_text` string
- `sort_by` string
- `sort_order` string
- `limit` string
- `prev` string
- `next` string

## Response `200`

Request Successful

- PaginationDtoEventListingDto
  - `records` EventListingDto[] — List of events for the current page.
    - `event_id` string — The unique identifier for the event.
    - `title` string — The title of the event.
    - `description` string — The description of the event.
    - `start_time` string — The start time of the event in UTC format.
    - `end_time` string — The end time of the event in UTC format.
    - `status` string — The current status of the event.
    - `registration_url` string — The URL for event registration
    - `name` string — The name of the event.
    - `event_type` string — Use to specify the type of event.
    - `location_type` string — Specifies if this is a physical or virtual event (of both), or if the location is to be specified in the future.
    - `time_zone_type` string — The type of time zone.
    - `address` AddressDto
      - `address_type` string, required — The address type. Only `EVENT` is currently supported.
      - `line1` string — The first line of the address where the event takes place.
      - `line2` string — The second line of the address where the event takes place.
      - `city` string — The city where the event takes place.
      - `country` string — Name of the country where the event takes place.
      - `country_code` string — The country code associated with the country where the event takes place.
      - `create_time` string — The create time of the event.
      - `last_update_time` string — The last modification time of the event.
      - `latitude` number, float — The latitude number indicating where the event takes place.
      - `longitude` number, float — The longitude number indicating where the event takes place.
      - `location_name` string — The venue name where the event takes place.
      - `postal_code` string — The address postal code.
      - `state` string — The State/Province where the event takes place.
      - `state_code` string — The state code where the event takes place.
    - `event_registration_summary_metrics` EventRegistrationSummaryMetricDto
      - `registration_count` integer — The total number of registrants for the event.
      - `ticket_sold` integer — The total number of tickets sold for the event.
      - `item_sold` integer — The total number of items sold for the event.
    - `create_time` string — The create time of the event in UTC format.
  - `total_records` integer — The total number of events across all pages.
  - `next_cursor` string — Use to get the next page of results.
  - `prev_cursor` string — Use to get the previous page of results.
  - `_links` Links — HATEOAS links for navigation. Is null if no additional navigation links are available.
    - `self` Href
      - `href` string
    - `next` Href
      - `href` string
    - `prev` Href
      - `href` string

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `500` — There was a problem with our internal service.
- `503` — Our internal service is temporarily unavailable.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/revisions/4b4a534c818d/schema)