> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Wix Events Collections

## Article: Wix Events Collections

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/cms/collection-management/wix-app-collections/wix-events-collections.md

## Article Content:

# Wix Events Collections

This article explains the fixed permissions and field structure for the following Wix Events collections:

- [Events](#events)
- [Tickets](#tickets)

> **Note:** These collections are system collections, so you can't change their permissions in the CMS.

<blockquote class="tip">

**Tip:**
Before continuing, make sure you've read [Working with Wix App Collections](https://dev.wix.com/docs/develop-websites/articles/databases/wix-data/collections/working-with-wix-app-collections-and-code.md).

</blockquote>

## Events

This section explains the permissions and fields available in the Events collection.

To use the Events collection in code, refer to it as `Events/Events`.

::::tabs
:::REST_TAB
```
curl -X POST \
  'https://www.wixapis.com/wix-data/v2/items/query' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "dataCollectionId": "Events/Events",
    "query": {}
  }'
```
:::
:::SDK_TAB
```js
import { items } from "@wix/data";

items.query("Events/Events")
  .find()
  .then((results) => {
    // handle the results
  });
```
:::
::::

### Permissions

The Events collection has the following [permissions](https://support.wix.com/en/article/cms-collection-permissions-overview):

- `read`: `ANYONE`
- `create`: None
- `update`: None
- `remove`: None

### Fields

This section describes each field in this collection and its properties.

> **Note:** This app collection contains read-only fields that cannot be managed from the collection. You can update the fields from the relevant app in your site’s [dashboard](https://support.wix.com/en/article/accessing-your-sites-dashboard).

Each field heading shows the field name followed by the field ID in parentheses, in the format "fieldName (`fieldId`)".

The fields are listed in the same order as the collection's default order in the CMS.

#### ID (`_id`)

**Description:** The event ID that was created by the server. This is a system field and is hidden by default.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** Yes

**Read-only:** Yes

#### Title (`title`)

**Description:** The event's name.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `lt`, `lte`, `gt`, `gte`, `hasSome`, `urlized`

**Read-only:** Yes

#### Slug (`slug`)

**Description:** The event's slug, which is its URL-friendly name that is unique across your site.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `hasSome`, `urlized`

**Read-only:** Yes

#### Description (`description`)

**Description:** The short teaser specified in the Events Dashboard.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### About (`about`)

<blockquote class="warning">

**Deprecated**

This field is deprecated and replaced by [`longDescription`](#long-description-longdescription).

</blockquote>

**Description:** The information you entered in the "About Your Event" section of the Events dashboard.

**Type:** Rich Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Long Description (`longDescription`)

**Description:** The information you entered in the "About Your Event" section of the Events Dashboard.

**Type:** Rich Content

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Main Image (`mainImage`)

**Description:** Displays the image for this event.

**Type:** Image

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Start (`start`)

**Description:** The start date and time of the event, if any. If the event schedule is TBD, this field is blank.

**Type:** Date and Time

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** Yes

**Read-only:** Yes

#### End (`end`)

**Description:** The end date and time of the event, if any. If the event schedule is TBD, this field is blank.

**Type:** Date and Time

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** Yes

**Read-only:** Yes

#### Time Zone (`timeZoneId`)

**Description:** The time zone for your event. If the event schedule is TBD, this field is blank.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Schedule TBD (`scheduleTbd`)

**Description:** Indicates whether the time of this event is marked as TBD.

**Type:** Boolean

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Schedule Formatted (`scheduleFormatted`)

**Description:** If the event has a date and time, the event's date and time, formatted according to your local settings, are displayed. Otherwise, the TBD message from the Events Dashboard is displayed.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Start Date Formatted (`scheduleStartDateFormatted`)

**Description:** The event's start date, formatted to your local settings, are displayed. If the event schedule is TBD, this field is blank.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Start Time Formatted (`scheduleStartTimeFormatted`)

**Description:** The event's start time, formatted to your local settings, are displayed. If the event schedule is TBD, this field is blank.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Location Name (`locationName`)

**Description:** If the event has a location, that location is displayed. Otherwise, the TBD message from the Events Dashboard is displayed.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Location Latitude (`latitude`)

**Description:** Event location address's latitude.

**Type:**Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Location Longitude (`longitude`)

**Description:** Event location address's longitude.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Location Address (`locationAddress`)

**Description:** The full address of the location. If the location is TBD, this field is blank.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Created (`created`)

**Description:** Displays the date and time the event was created.

**Type:** Date and Time

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** No

**Read-only:** Yes

#### Modified (`modified`)

**Description:** Displays the date and time the event was last modified.

**Type:** Date and Time

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** No

**Read-only:** Yes

#### Status (`status`)

**Description:** The current status of the event, as follows:

- SCHEDULED: The event date is in the future.
- STARTED: The event start time has arrived.
- ENDED: The event end time has passed.
- CANCELED: The event was canceled.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** `eq`, `ne`, `hasSome`

**Read-only:** Yes

#### Type (`type`)

**Description:** The type of event, as follows:

- RSVP: The event is set up to accept RSVP registration via your Wix page.
- TICKETS: The event is set up to sell tickets.
- EXTERNAL: The event is set up to accept registration via an external page

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Registration Status (`registrationStatus`)

**Description:** The registration status, as follows:

- OPEN\_RSVP: RSVP registration is open.
- OPEN\_TICKETS: Ticket sales for this event are open.
- OPEN\_EXTERNAL: RSVP registration or ticket sales are closed but registration via an external site is open.
- OPEN-RSVP\_WAITLIST: The RSVP list is full but requests can be added to a waitlist.
- CLOSED: RSVP registration or ticket sales are closed.
- CLOSED\_MANUALLY: RSVP registration or ticket sales have been closed manually in the Events Dashboard.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Lowest Price Formatted (`lowestPriceFormatted`)

**Description:** The lowest price available, formatted with your currency.

- If this event has RSVP registration or is external, this field is blank. 
- If tickets are sold for this event, the lowest price available is displayed. 
- If free tickets are offered, "Free" is displayed.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Highest Price Formatted (`highestPriceFormatted`)

**Description:** The highest price available, formatted with your currency.

- If this event has RSVP registration, this field is blank. 
- If tickets are sold for this event, the highest price available is displayed. 
- If only free tickets are offered, "Free" is displayed.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Google Calendar URL (`googleCalendarUrl`)

**Description:** Displays an "Add to Google calendar" link to the event.

**Type:** URL

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### iCalendar URL (`iCalendarUrl`)

**Description:** Displays an iCalendar download link to the event.

**Type:** URL

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Site Event Page URL (`siteEventPageUrl`)

**Description:** The event's URL-friendly name that is unique across your site.

**Type:** URL

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Registration URL (`registrationURL`)

**Description:** Registration URL if registration for the Wix event managed externally. Guests go to this URL to register.

**Type:** URL

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Creator ID (`UserID`)

**Description:** ID of the creator of the event. 

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** Yes

**Read-only:** Yes

## Tickets

This section explains the permissions and fields available in the Tickets collection.

To use the Tickets collection in code, refer to it as `Events/Tickets`.

::::tabs
:::REST_TAB
```
curl -X POST \
  'https://www.wixapis.com/wix-data/v2/items/query' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: <AUTH>' \
  -d '{
    "dataCollectionId": "Events/Tickets",
    "query": {}
  }'
```
:::
:::SDK_TAB
```js
import { items } from "@wix/data";

items.query("Events/Tickets")
  .find()
  .then((results) => {
    // handle the results
  });
```
:::
::::

### Permissions

The Tickets collection has the following [permissions](https://support.wix.com/en/article/cms-collection-permissions-overview):

- `read`: `ANYONE`
- `create`: None
- `update`: None
- `remove`: None

### Fields

This section describes each field in this collection and its properties.

> **Note:** This app collection contains read-only fields that cannot be managed from the collection. You can update the fields from the relevant app in your site’s [dashboard](https://support.wix.com/en/article/accessing-your-sites-dashboard).

Each field heading shows the field name followed by the field ID in parentheses, in the format "fieldName (`fieldId`)".

The fields are listed in the same order as the collection's default order in the CMS.

#### ID (`_id`)

**Description:** The ticket ID that was created by the server. This is a system field and is hidden by default.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** No

**Filter Support:** `is`, `is not`

**Read-only:** Yes

#### Name (`name`)

**Description:** The ticket's name.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** Yes

**Sortable:** Yes

**Filter Support:** `is`, `is not`

**Read-only:** Yes

#### Event (`event`)

**Description:** The event that the ticket is valid for.

**Type:** Reference to the [Events/Events collection](#events)

**Can connect to data:** Yes, to the referenced item's fields

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** Yes

**Read-only:** Yes

#### Description (`description`)

**Description:** Description of the ticket which appears on the purchase page to give customers more details about what’s included in the ticket.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Price (`price`)

**Description:** The ticket price.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** No

**Read-only:** Yes

#### Currency (`currency`)

**Description:** The currency of the ticket price.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Tax Amount (`tax`)

**Description:** The tax charged for the ticket.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Fee Amount (`fee`)

**Description:** The fee for the ticket.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Limit Per Checkout (`limitPerCheckout`)

**Description:** Maximum number of tickets that can be checked out at once.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Remaining Tickets (`remainingTickets`)

**Description:** The number of remaining tickets.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

**Notes:** The maximum value in this field is 20. If there are more than 20 tickets remaining, the value in this field will be 20.

#### Policy (`policy`)

**Description:** The ticket policy which appears on the bottom of the ticket.

**Type:** Text

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** No

**Filter Support:** No

**Read-only:** Yes

#### Final Price (`finalPrice`)

**Description:** The final price for the ticket.

**Type:** Number

**Can connect to data:** Yes

**Can use in dynamic page URL:** No

**Sortable:** Yes

**Filter Support:** No

**Read-only:** Yes