--- title: "List event occurrences" method: GET path: "/v1/event_series/{event_series_id}/events" tags: ["Event series"] --- # List event occurrences `GET /v1/event_series/{event_series_id}/events` For the given event series ID, find all the associated events and list them ## Query parameters - `start_at` integer - `start_at.gt` integer - `start_at.gte` integer - `start_at.lt` integer - `start_at.lte` integer - `end_at` integer - `end_at.gt` integer - `end_at.gte` integer - `end_at.lt` integer - `end_at.lte` integer - `starting_after` string - `ending_before` string - `limit` string - `override_id` string ## Response `200` Successfully returned list of event occurrences - object - `data` EventOccurrence[] - `object` string - `id` string — A unique identifier for the event occurrence - `available_status` string, nullable — Optional custom status message when event is set to be available - `bundles` Bundle[], nullable — List of associated bundles - `object` string - `id` string - `access_code` string, nullable — Code to access a bundle - `booking_fee` integer — Booking fee in cents - `description` string — Bundle description - `group_id` string, nullable — Bundle group ID - `name` string — Bundle name - `price` integer — Price in cents - `products` object[] — Array of associated products - `id` string — A unique product identifier - `quantity` integer — Product quantity - `status` 'HIDDEN' | 'UNAVAILABLE' | 'ON_SALE' | 'SOLD_OUT' — Bundle status - `ticket_types` object[] — Array of associated ticket types - `id` string — A unique ticket type identifier - `quantity` integer — Ticket type quantity - `chk` string — Used for Ticket Tailor checkout chk value - `currency` 'gbp' | 'usd' | 'eur' | 'sgd' | 'aud' | 'brl' | 'cad' | 'czk' | 'dkk' | 'hkd' | 'huf' | 'ils' | 'jpy' | 'myr' | 'mxn' | 'nok' | 'nzd' | 'php' | 'pln' | 'rub' | 'sek' | 'chf' | 'twd' | 'thb' | 'try' — Information about the currency the event is configured to use - `end` object — The end date and time for the event - `date` string — ISO-8601 date for the end of the event - `formatted` string — A formatted date string for the end of the event - `iso` string — ISO-8601 date and time for the end of the event - `time` string — Time of the end of the event - `timezone` string — Timezone offset for the end of the event - `unix` integer — Unix timestamp for for the end of the event - `event_series_id` string — A unique identifier for the associated event series - `hidden` string — True, if event is set to hidden - `online_link` string, nullable — URL of the online event - `override_id` string, nullable — A unique identifier for the associated override - `revenue` number — Total revenue of the event - `sales_tax_label` string, nullable — The label for the sales tax - `sales_tax_percentage` integer, nullable — The percentage of the sales tax - `sales_tax_treatment` 'inclusive' | 'exclusive', nullable — The treatment of the sales tax - `start` object — The start date and time for the event - `date` string — ISO-8601 date for the start of the event - `formatted` string — A formatted date string for the start of the event - `iso` string — ISO-8601 date and time for the start of the event - `time` string — Time of the start of the event - `timezone` string — Timezone offset for the start of the event - `unix` integer — Unix timestamp for the start of the event - `max_tickets_sold_per_occurrence` integer, nullable — Maximum quantity of tickets that can be sold across all ticket types - `tickets_available` string, nullable — Are there any ticket types available? - `ticket_groups` TicketGroup[], nullable - `object` string - `id` string — A unique identifier for the ticket group - `bundle_ids` string[], nullable — An array of associated bundle ids - `max_per_order` integer, nullable — Maximum number of tickets allowed per order - `max_quantity` integer, nullable — Maximum quantity of tickets that are allowed to be sold for the tickets in the group - `min_per_order` integer, nullable — Minimum number of tickets allowed per order - `name` string — Name of the ticket group - `sort_order` integer — Sort index of the group in the UI - `ticket_ids` string[] — An array of associated ticket type ids - `ticket_types` TicketType[], nullable - `object` string, required - `id` string, required — A unique identifier for the ticket type - `access_code` string, nullable, required — Code to access a hidden ticket - `booking_fee` integer, required — Optional booking fee which is charged per ticket type to the customer and the funds are paid to you. - `description` string, nullable, required - `discounts` string[] — An array of associated discounts - `group_id` string, nullable, required — ID of the group this ticket type belongs to - `has_overrides` 'true' | 'false' — Specifies whether the ticket type has overrides - `hide_after` object, nullable — Timestamp in seconds when the ticket type should be hidden until. - `date` string — ISO-8601 date for the start of the event - `formatted` string — A formatted date string for the start of the event - `iso` string — ISO-8601 date and time for the start of the event - `time` string — Time for the start of the event - `timezone` string — Timezone offset for the start of the event - `unix` integer — Unix timestamp for the start of the event - `hide_until` object, nullable — Timestamp in seconds when the ticket type should be hidden after. - `date` string — ISO-8601 date for the start of the event - `formatted` string — A formatted date string for the start of the event - `iso` string — ISO-8601 date and time for the start of the event - `time` string — Time for the start of the event - `timezone` string — Timezone offset for the start of the event - `unix` integer — Unix timestamp for the start of the event - `hide_when_sold_out` 'true' | 'false' — Specifies whether the ticket is hidden when it has sold out - `max_per_order` integer, required — Maximum number of ticket types you can select per order - `min_per_order` integer, required — Minimum number of ticket types you can select per order - `name` string, required — Name of the ticket type - `override_id` string, nullable — The ID of the override associated with the ticket type - `price` union, required — Cost of the ticket type - integer - number - `show_quantity_remaining` 'true' | 'false' — Specifies whether to show the number of tickets still available - `show_quantity_remaining_less_than` integer, nullable — Only show number of tickets still available when the available quantity is equal to or lower than this threshold - `status` 'on_sale' | 'sold_out' | 'unavailable' | 'hidden' | 'admin_only' | 'locked', required — Status of the ticket type - `sort_order` integer, required — Sort index of ticket type in the UI - `type` 'paid' | 'free', required - `quantity` integer, required — Number available for purchase - `quantity_held` integer, required — Number held - `quantity_in_baskets` integer — Number in baskets - `quantity_issued` integer, required — Number issued - `quantity_total` integer, required — Total number including issued and still available - `total_issued_tickets` integer — Total number of issued tickets - `transaction_fee_fixed_amount` integer, nullable — Fixed amount of the transaction fee - `transaction_fee_percentage` integer, nullable — Percentage of the transaction fee - `unavailable` string — True, if event is set to unavailable - `unavailable_status` string, nullable — Optional custom status message when event is set to be unavailable - `url` string — Event occurrence URL - `links` object - `next` string, nullable - `previous` string, nullable ## Other responses - `default` — Error schema --- [API](https://skmtc.net/tickettailor/apis/ticket-tailor-api.md) · [All operations](https://skmtc.net/tickettailor/apis/ticket-tailor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tickettailor/ticket-tailor-api/revisions/7b222e8ec91c/schema)