{"id":"c23b725a-d20e-4da1-b3b6-93a4e9381238","createdDate":"2024-07-09T05:56:38.853Z","updatedDate":"2024-07-09T05:56:38.853Z","resourceId":"a45adbef-99e5-4cca-a23a-cbd7fb27696d","sdk":{"schema":{"name":"velo-deps_wix-events.v2_guests","fqn":"","slug":"velo-deps-wix-events-v2-guests","typesMap":{"ListGuestListPreviewsResponse":{"name":"ListGuestListPreviewsResponse","fqn":"ListGuestListPreviewsResponse","slug":"list-guest-list-previews-response","actions":[],"properties":[{"name":"pagingMetadata","slug":"paging-metadata","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"PagingMetadataV2","referenceFqn":"PagingMetadataV2"},"description":"Metadata for the paginated results."},{"name":"previews","slug":"previews","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"REFERENCE","name":"GuestListPreview","referenceFqn":"GuestListPreview"}},"description":"List of guests."}]},"PagingMetadataV2":{"name":"PagingMetadataV2","fqn":"PagingMetadataV2","slug":"paging-metadata-v2","actions":[],"properties":[{"name":"count","slug":"count","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Number of items returned in the response."},{"name":"cursors","slug":"cursors","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"Cursors","referenceFqn":"Cursors"},"description":"Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used."},{"name":"offset","slug":"offset","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Offset that was requested."},{"name":"tooManyToCount","slug":"too-many-to-count","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"boolean"},"description":"Flag that indicates the server failed to calculate the `total` field."},{"name":"total","slug":"total","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Total number of items that match the query. Returned if requested in query."}]},"Cursors":{"name":"Cursors","fqn":"Cursors","slug":"cursors","actions":[],"properties":[{"name":"next","slug":"next","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Cursor pointing to next page in the list of results."},{"name":"prev","slug":"prev","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Cursor pointing to previous page in the list of results."}]},"GuestListPreview":{"name":"GuestListPreview","fqn":"GuestListPreview","slug":"guest-list-preview","actions":[],"properties":[{"name":"attending","slug":"attending","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"GuestCount","referenceFqn":"GuestCount"},"description":"Attending guests count."},{"name":"eventId","slug":"event-id","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Event id."},{"name":"inWaitlist","slug":"in-waitlist","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"GuestCount","referenceFqn":"GuestCount"},"description":"Waiting guests count."},{"name":"latestAttendingMembers","slug":"latest-attending-members","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"EventGuests","referenceFqn":"EventGuests"},"description":"Latest attending members"},{"name":"notAttending","slug":"not-attending","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"GuestCount","referenceFqn":"GuestCount"},"description":"Not attending guests count."}]},"GuestCount":{"name":"GuestCount","fqn":"GuestCount","slug":"guest-count","actions":[],"properties":[{"name":"count","slug":"count","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"EventGuest count (RSVP, TICKET_HOLDER, BUYER);"},{"name":"totalEventGuests","slug":"total-event-guests","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Total guest count. For Rsvp Event every RSVP guest and additional guest count, for Ticketed Event count of TICKET_HOLDER"}]},"EventGuests":{"name":"EventGuests","fqn":"EventGuests","slug":"event-guests","actions":[],"properties":[{"name":"guests","slug":"guests","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"REFERENCE","name":"EventGuest","referenceFqn":"EventGuest"}}}]},"EventGuest":{"name":"EventGuest","fqn":"EventGuest","slug":"event-guest","actions":[],"properties":[{"name":"_createdDate","slug":"created-date","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"DATE"},"description":"Date and time the guest was created in `yyyy-mm-ddThh:mm:sssZ` format."},{"name":"_id","slug":"id","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Guest ID."},{"name":"_updatedDate","slug":"updated-date","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"DATE"},"description":"Date and time the guest was updated in `yyyy-mm-ddThh:mm:sssZ` format."},{"name":"attendanceStatus","slug":"attendance-status","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"AttendanceStatus","referenceFqn":"AttendanceStatus"},"description":"Attendance status.

**Note:** For `guestType` `BUYER` or `TICKET_HOLDER` the `IN_WAITLIST` value is not applicable."},{"name":"attendanceStatusUpdatedDate","slug":"attendance-status-updated-date","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"DATE"},"description":"Date and time of guest's latest attendance status update."},{"name":"contactId","slug":"contact-id","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Guest's contact ID. See [Contacts API](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4) for more details."},{"name":"eventId","slug":"event-id","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Event ID."},{"name":"guestDetails","slug":"guest-details","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"GuestDetails","referenceFqn":"GuestDetails"},"description":"Guest details.

Returned only when the `guestDetails` fieldset is sent in the request."},{"name":"guestType","slug":"guest-type","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"GuestType","referenceFqn":"GuestType"},"description":"Guest type:

`RSVP`: An invited guest, no ticket necessary.

`BUYER`: The guest who bought the tickets.

`TICKET_HOLDER`: The guest for whom the ticket was bought."},{"name":"locale","slug":"locale","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Locale in [IETF BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag) format. Used when the event date and time on a ticket should be formatted into another locale."},{"name":"memberId","slug":"member-id","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Site member ID."},{"name":"orderNumber","slug":"order-number","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Order number.

**Note:** Only applicable when `guestType` is `BUYER` or `TICKET_HOLDER`."},{"name":"revision","slug":"revision","isReadOnly":true,"isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Guest revision"},{"name":"rsvpId","slug":"rsvp-id","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"RSVP ID.

**Note:** Only applicable when `guestType` is `RSVP`."},{"name":"secondaryLanguageCode","slug":"secondary-language-code","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Secondary language code in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format. Used when the event ticket should be translated into another language."},{"name":"ticketNumber","slug":"ticket-number","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Ticket number.

**Note:** Only applicable when `guestType` is `TICKET_HOLDER`."},{"name":"tickets","slug":"tickets","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"REFERENCE","name":"TicketDetails","referenceFqn":"TicketDetails"}},"description":"List of names, numbers, and definition IDs for each ticket."},{"name":"totalGuests","slug":"total-guests","isReadOnly":true,"isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Number of current guest plus additional guests"}]},"AttendanceStatus":{"name":"AttendanceStatus","fqn":"AttendanceStatus","slug":"attendance-status","actions":[],"enumValues":["ATTENDING","IN_WAITLIST","NOT_ATTENDING"],"properties":[]},"GuestDetails":{"name":"GuestDetails","fqn":"GuestDetails","slug":"guest-details","actions":[],"properties":[{"name":"checkedIn","slug":"checked-in","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"boolean"},"description":"Whether the guest has checked into the event."},{"name":"email","slug":"email","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Email."},{"name":"firstName","slug":"first-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"First name."},{"name":"formResponse","slug":"form-response","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"FormResponse","referenceFqn":"FormResponse"},"description":"Form response."},{"name":"lastName","slug":"last-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Last name."},{"name":"onlineConferencingLogin","slug":"online-conferencing-login","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"OnlineConferencingLogin","referenceFqn":"OnlineConferencingLogin"},"description":"The login details for the guest to access the online conference event."}]},"FormResponse":{"name":"FormResponse","fqn":"FormResponse","slug":"form-response","actions":[],"properties":[{"name":"inputValues","slug":"input-values","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"REFERENCE","name":"InputValue","referenceFqn":"InputValue"}}}]},"InputValue":{"name":"InputValue","fqn":"InputValue","slug":"input-value","actions":[],"properties":[{"name":"inputName","slug":"input-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"}},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"}},{"name":"values","slug":"values","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"PRIMITIVE","name":"string"}}}]},"FormattedAddress":{"name":"FormattedAddress","fqn":"FormattedAddress","slug":"formatted-address","actions":[],"properties":[{"name":"address","slug":"address","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"Address","referenceFqn":"Address"},"description":"Address components (optional)."},{"name":"formatted","slug":"formatted","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"One line address representation."}]},"Address":{"name":"Address","fqn":"Address","slug":"address","actions":[],"oneofProperties":{"street":[{"name":"addressLine","slug":"address-line","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Main address line, usually street and number as free text."},{"name":"streetAddress","slug":"street-address","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"StreetAddress","referenceFqn":"StreetAddress"},"description":"Street name and number."}]},"properties":[{"name":"addressLine1","slug":"address-line1","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Main address line, usually street and number as free text."},{"name":"addressLine2","slug":"address-line2","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Free text providing more detailed address info. Usually contains Apt, Suite, and Floor."},{"name":"city","slug":"city","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"City name."},{"name":"country","slug":"country","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Country code."},{"name":"postalCode","slug":"postal-code","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Zip/postal code."},{"name":"subdivision","slug":"subdivision","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Subdivision shorthand. Usually, a short code (2 or 3 letters) that represents a state, region, prefecture, or province. e.g. NY"}]},"AddressLocation":{"name":"AddressLocation","fqn":"AddressLocation","slug":"address-location","actions":[],"properties":[{"name":"latitude","slug":"latitude","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Address latitude."},{"name":"longitude","slug":"longitude","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Address longitude."}]},"StreetAddress":{"name":"StreetAddress","fqn":"StreetAddress","slug":"street-address","actions":[],"properties":[{"name":"name","slug":"name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Street name."},{"name":"number","slug":"number","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Street number."}]},"OnlineConferencingLogin":{"name":"OnlineConferencingLogin","fqn":"OnlineConferencingLogin","slug":"online-conferencing-login","actions":[],"properties":[{"name":"link","slug":"link","isReadOnly":true,"isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Link URL to the online conference."},{"name":"password","slug":"password","isReadOnly":true,"isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Password for the online conference."}]},"GuestType":{"name":"GuestType","fqn":"GuestType","slug":"guest-type","actions":[],"enumValues":["BUYER","RSVP","TICKET_HOLDER"],"properties":[]},"TicketDetails":{"name":"TicketDetails","fqn":"TicketDetails","slug":"ticket-details","actions":[],"properties":[{"name":"definitionId","slug":"definition-id","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Ticket definition ID."},{"name":"name","slug":"name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Ticket name."},{"name":"number","slug":"number","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Ticket number."}]},"TicketGuestDetails":{"name":"TicketGuestDetails","fqn":"TicketGuestDetails","slug":"ticket-guest-details","actions":[],"properties":[{"name":"firstName","slug":"first-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"First name."},{"name":"lastName","slug":"last-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Last name."},{"name":"onlineConferencingLogin","slug":"online-conferencing-login","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"OnlineConferencingLogin","referenceFqn":"OnlineConferencingLogin"},"description":"The login details for the guest to access the online conference event."}]},"ListGuestListPreviewsOptions":{"name":"ListGuestListPreviewsOptions","fqn":"ListGuestListPreviewsOptions","slug":"list-guest-list-previews-options","actions":[],"properties":[{"name":"cursorPaging","slug":"cursor-paging","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"CursorPaging","referenceFqn":"CursorPaging"},"description":"Cursor paging."},{"name":"fields","slug":"fields","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"REFERENCE","name":"RequestedFields","referenceFqn":"RequestedFields"}},"description":"Requested fields."}]},"CursorPaging":{"name":"CursorPaging","fqn":"CursorPaging","slug":"cursor-paging","actions":[],"properties":[{"name":"cursor","slug":"cursor","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Pointer to the next or previous page in the list of results.\n\nYou can get the relevant cursor token\nfrom the `pagingMetadata` object in the previous call's response.\nNot relevant for the first request."},{"name":"limit","slug":"limit","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"number"},"description":"Number of items to load per page."}]},"RequestedFields":{"name":"RequestedFields","fqn":"RequestedFields","slug":"requested-fields","actions":[],"enumValues":["MEMBER_GUESTS","UNKNOWN_REQUESTED_FIELD","WAITLIST_COUNT"],"properties":[]},"GuestsQueryBuilder":{"name":"GuestsQueryBuilder","fqn":"GuestsQueryBuilder","slug":"guests-query-builder","actions":[{"name":"ascending","fqn":"GuestsQueryBuilder.ascending","slug":"ascending","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add an `ascending` sort to a query","content":"const query = guests.queryGuests.ascending('_createdDate');\n"},{"title":"Create a query, add an `ascending` sort, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().ascending('_createdDate').find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyNames","slug":"property-names","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"PRIMITIVE","name":"string"}},"description":"Properties used in the sort. To sort by multiple properties, pass properties as additional arguments."}],"description":"Adds a sort to a query, sorting by the specified properties in ascending order.\n\nThe `ascending()` function refines a `GuestsQueryBuilder` to sort by the value of `propertyName` in ascending order.\nYou can specify multiple properties for sorting in ascending order by passing each property name as an additional argument. `ascending()` sorts the results in the order the properties are passed.\nYou can sort the following types:\n- Number: Sorts numerically.\n- Date: Sorts by date and time.\n- String: Sorts lexicographically, so `'abc'` comes after `'XYZ'`.\nIf a property contains a number stored as a string (for example, `'0'`), that value is sorted alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest."},{"name":"descending","fqn":"GuestsQueryBuilder.descending","slug":"descending","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add a `descending` sort to a query","content":"const query = guests.queryGuests.descending('_createdDate');\n"},{"title":"Create a query, add a `descending` sort, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().descending('_createdDate').find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyNames","slug":"property-names","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"PRIMITIVE","name":"string"}},"description":"Properties used in the sort. To sort by multiple properties, pass properties as additional arguments."}],"description":"Adds a sort to a query, sorting by the specified properties in descending order.\n\nThe `descending()` function refines a `GuestsQueryBuilder` to sort by the value of `propertyName` in descending order.\nYou can specify multiple properties for sorting in descending order by passing each property name as an additional argument. `descending()` sorts the results in the order the properties are passed.\nYou can sort the following types:\n- Number: Sorts numerically.\n- Date: Sorts by date and time.\n- String: Sorts lexicographically, so `'abc'` comes after `'XYZ'`.\nIf a property contains a number stored as a string (for example, `'0'`), that value is sorted alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest."},{"name":"eq","fqn":"GuestsQueryBuilder.eq","slug":"eq","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add an `eq` filter to a query","content":"const query = guests.queryGuests.eq('_id', 'some-id');\n"},{"title":"Create a query, add an `eq` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .eq('_id', 'bb19b637-74ce-55d3-ae32-430b588051da')\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Property whose value is compared with `value`."},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"any"},"description":"Value to compare against."}],"description":"Refines a query to match items where the specified property equals the specified value.\n\nThe `eq()` function refines a `GuestsQueryBuilder` to match only items where the value of the specified `propertyName` equals the specified `value`.\n`eq()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string.\nMatching strings with `eq()` is case-sensitive, so `'text'` isn't equal to `'Text'`."},{"name":"exists","fqn":"GuestsQueryBuilder.exists","slug":"exists","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add an `exists` filter to a query","content":"const query = guests.queryGuests.exists('description', 'some-description');\n"},{"title":"Create a query, add an `exists` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .exists('description', 'some-description')\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"}},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"boolean"}}],"description":"Refines a query to match items where the specified property contains a value.\n\nThe `exists()` function refines a `GuestsQueryBuilder` to only match items where the value of the specified `propertyName` doesn't equal null or undefined.\n `exists()` checks for either existence or non-existence based on the boolen parameter. Note that `exists()` does match items where the value of the specified `propertyName` is an empty string or an invalid value. `exists()` is only useful for properties which don't contain default values and therefore their values may be unassigned."},{"name":"find","fqn":"GuestsQueryBuilder.find","slug":"find","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"PROMISE","argumentType":{"kind":"REFERENCE","name":"GuestsQueryResult","referenceFqn":"GuestsQueryResult"}},"examples":[{"title":"Run a query with no filters","content":"const query = guests.queryGuests.find();\n"},{"title":"Perform a `find` on a query","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"description":"Returns the query results.\n\nThe `find()` function returns a Promise that resolves to the query results and metadata.\nThe Promise is rejected if `find()` is called with insufficient permissions or if any of the previous functions used to refine the query are invalid."},{"name":"ge","fqn":"GuestsQueryBuilder.ge","slug":"ge","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add a `ge` filter to a query","content":"const query = guests.queryGuests.ge('_createdDate', '2021-03-01');\n"},{"title":"Create a query, add a `ge` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .ge('_createdDate', '2021-03-01')\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Property whose value is compared with `value`."},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"any"},"description":"Value to compare against."}],"description":"Refines a query to match items where the specified property is greater than or equal to the specified value.\n\nThe `ge()` function refines a `GuestsQueryBuilder` to match only items where the value of the specified `propertyName` is greater than or equal to the specified `value`.\n`ge()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string.\nIf a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest.\nThe following types of properties can be compared:\n- Number: Compares numerically.\n- Date: Compares JavaScript Date objects. \n- String: Compares lexicographically, so `'abc'` is greater than `'ABC'`."},{"name":"gt","fqn":"GuestsQueryBuilder.gt","slug":"gt","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add a `gt` filter to a query","content":"const query = guests.queryGuests.gt('_createdDate', '2021-03-01');\n"},{"title":"Create a query, add a `gt` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .gt('_createdDate', '2021-03-01')\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Property whose value is compared with `value`."},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"any"},"description":"Value to compare against."}],"description":"Refines a query to match items where the specified property is greater than the specified value.\n\nThe `gt()` function refines a `GuestsQueryBuilder` to match only items where the value of the specified `propertyName` is greater than the specified `value`.\n`gt()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string.\nIf a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest.\nThe following types of properties can be compared:\n- Number: Compares numerically.\n- Date: Compares JavaScript Date objects. \n- String: Compares lexicographically, so `'abc'` is greater than `'ABC'`."},{"name":"in","fqn":"GuestsQueryBuilder.in","slug":"in","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add an `in` filter to a query","content":"const query = guests.queryGuests.in(\n ['labelIds', 'colors'],\n ['red', 'blue', 'purple']\n);\n"},{"title":"Create a query, add an `in` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .in(['labelIds', 'colors'], ['red', 'blue', 'purple'])\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"}},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"any"}}],"description":"Refines a query to only match items where the specified property conatins any of the values in the provided array of values.\n\nThe `in()` function refines a `GuestsQueryBuilder` to match only items where the specified `propertyName` is equal to any of the values in the provided array.\nMatching strings with `in()` is case-sensitive, so `'text'` isn't equal to `'Text'`."},{"name":"le","fqn":"GuestsQueryBuilder.le","slug":"le","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add an `le` filter to a query","content":"const query = guests.queryGuests.le('_createdDate', '2021-03-01');\n"},{"title":"Create a query, add an `le` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .le('_createdDate', '2021-03-01')\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Property whose value is compared with `value`."},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"any"},"description":"Value to compare against."}],"description":"Refines a query to match items where the specified property is less than or equal to the specified value.\n\nThe `le()` function refines a `GuestsQueryBuilder` to match only items where the value of the specified `propertyName` is less than or equal to the specified `value`.\n`le()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string.\nIf a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest.\nThe following types of properties can be compared:\n- Number: Compares numerically.\n- Date: Compares JavaScript Date objects. \n- String: Compares lexicographically, so `'ABC'` is less than `'abc'`."},{"name":"limit","fqn":"GuestsQueryBuilder.limit","slug":"limit","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add a `limit` to a query","content":"const query = guests.queryGuests.limit(10);\n"},{"title":"Create a query, add a `limit`, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().limit(10).find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"limit","slug":"limit","isDeprecated":false,"isInternal":false,"maturity":"GA","examples":[{"title":"Add a `limit` to a query","content":"const query = guests.queryGuests.limit(10);\n"},{"title":"Create a query, add a `limit`, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().limit(10).find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"type":{"kind":"PRIMITIVE","name":"number"},"description":"Number of items to return, which is also the `pageSize` of the results object."}],"description":"Limits the number of items the query returns.\n\nThe `limit()` function defines the number of results a query returns in each page. Only one page of results is retrieved at a time.\nYou can use the `next()` and `prev()` functions to navigate the pages of a query result."},{"name":"lt","fqn":"GuestsQueryBuilder.lt","slug":"lt","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add an `lt` filter to a query","content":"const query = guests.queryGuests.lt('_createdDate', '2021-03-01');\n"},{"title":"Create a query, add an `lt` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .lt('_createdDate', '2021-03-01')\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Property whose value is compared with `value`."},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"any"},"description":"Value to compare against."}],"description":"Refines a query to match items where the specified property is less than the specified value.\n\nThe `le()` function refines a `GuestsQueryBuilder` to match only items where the value of the specified `propertyName` is less than the specified `value`.\n`le()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string.\nIf a property contains a number stored as a string (for example, `'0'`), that value is compared alphabetically and not numerically. If a property doesn't have a value, that value is ranked lowest.\nThe following types of properties can be compared:\n- Number: Compares numerically.\n- Date: Compares JavaScript Date objects. \n- String: Compares lexicographically, so `'ABC'` is less than `'abc'`."},{"name":"ne","fqn":"GuestsQueryBuilder.ne","slug":"ne","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Add an `ne` filter to a query","content":"const query = guests.queryGuests.ne(\n '_id',\n 'bb19b637-74ce-55d3-ae32-430b588051da'\n);\n"},{"title":"Create a query, add an `ne` filter, and run it","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests\n .queryGuests()\n .ne('_id', 'bb19b637-74ce-55d3-ae32-430b588051da')\n .find();\n\n if (results.items.length > 0) {\n const items = results.items;\n const firstItem = items[0];\n const pageSize = results.pageSize;\n const hasNext = results.hasNext();\n const hasPrev = results.hasPrev();\n const length = results.length;\n const query = results.query;\n\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"actionParams":[{"name":"propertyName","slug":"property-name","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"Property whose value is compared with `value`."},{"name":"value","slug":"value","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"any"},"description":"Value to compare against."}],"description":"Refines a query to match items where the specified property doesn't equal the specified value.\n\nThe `ne()` function refines a `GuestsQueryBuilder` to match only items where the value of the specified `propertyName` doesn't equal the specified `value`.\n`ne()` matches only values of the same type. For example, `0` stored as a number doesn't match `'0'` stored as a string.\nMatching strings with `ne()` is case-sensitive, so `'text'` isn't equal to `'Text'`."},{"name":"skipTo","fqn":"GuestsQueryBuilder.skipTo","slug":"skip-to","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Perform a query and skip to the next cursor","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n const nextCursor = results.cursors.next;\n return guests.queryGuests().skipTo(nextCursor).find();\n}\n"},{"title":"Perform a query and skip to the previous cursor","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n const prevCursor = results.cursors.prev;\n return guests.queryGuests().skipTo(prevCursor).find();\n}\n"}],"actionParams":[{"name":"cursor","slug":"cursor","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"PRIMITIVE","name":"string"},"description":"A pointer to specific record"}],"description":"Refines a query that skips to a specific record.\n\nThe `skipTo()` function refines a `GuestsQueryBuilder` to return items that appear before or after the item pointed to by the provided cursor. Get the relevant cursor for a specific item from the `cursors` object in previous call's response. Then you can skip to `cursors.prev` to return items before the cursor, or `cursors.next` to return items after the cursor.\n \nWhen using `skipTo()`, the filters and the sorting order of the original query can't be changed. Only the `limit()` property of the query can be changed."}],"properties":[]},"GuestsQueryResult":{"name":"GuestsQueryResult","fqn":"GuestsQueryResult","slug":"guests-query-result","actions":[{"name":"hasNext","fqn":"GuestsQueryResult.hasNext","slug":"has-next","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"PRIMITIVE","name":"boolean"},"examples":[{"title":"Get whether the query has more results","content":"const hasNext = results.hasNext();\n"},{"title":"Perform a query and get `hasNext` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n return results.hasNext();\n}\n"}],"description":"Indicates whether the query has more results.\n\nYou can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `guests` to navigate the pages of a query result."},{"name":"hasPrev","fqn":"GuestsQueryResult.hasPrev","slug":"has-prev","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"PRIMITIVE","name":"boolean"},"examples":[{"title":"Get whether the query has previous results","content":"const hasPrev = results.hasPrev();\n"},{"title":"Perform a query and get `hasPrev` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n return results.hasPrev();\n}\n"}],"description":"Indicates whether the query has previous results.\n\nYou can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `guests` to navigate the pages of a query result."},{"name":"next","fqn":"GuestsQueryResult.next","slug":"next","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"PROMISE","argumentType":{"kind":"REFERENCE","name":"GuestsQueryResult","referenceFqn":"GuestsQueryResult"}},"examples":[{"title":"Get `next` from a query result","content":"const nextPage = results.next();\n"},{"title":"Perform a query and get `next` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n return results.next();\n}\n"},{"title":"Iterate through all pages of query results","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n let allItems = [];\n\n const results = await guests.queryGuests().limit(1000).find();\n allItems.push(results.items);\n\n while (results.hasNext()) {\n results = await results.next();\n allItems.push(results.items);\n }\n\n return allItems;\n}\n"}],"description":"Retrieves the next page of query results.\n\nThe `next()` function retrieves the next page of query results.\nThe page size is defined by the [`limit()`](wix-events-v2/guests/guests-query-builder#limit) function and can be retrieved using the [`pageSize`](#pagesize) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `guests` to navigate the pages of a query result.\nIf items are added or removed between calls to `next()`, the values returned by `GuestsQueryBuilder` may change."},{"name":"prev","fqn":"GuestsQueryResult.prev","slug":"prev","isDeprecated":false,"isInternal":false,"maturity":"GA","adminMethod":false,"returnType":{"kind":"PROMISE","argumentType":{"kind":"REFERENCE","name":"GuestsQueryResult","referenceFqn":"GuestsQueryResult"}},"examples":[{"title":"Get `prev` from a query result","content":"const previousPage = results.prev();\n"},{"title":"Perform a query and get `prev` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n return results.prev();\n}\n"}],"description":"Retrieves the previous page of query results.\n\nThe `prev()` function retrieves the previous page of query results.\nThe page size is defined by the [`limit()`](wix-events-v2/guests/guests-query-builder#limit) function and can be retrieved using the [`pageSize`](#pagesize) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `guests` to navigate the pages of a query result.\nIf items are added or removed between calls to `prev()`, the values returned may change."}],"properties":[{"name":"cursors","slug":"cursors","isDeprecated":false,"isInternal":false,"maturity":"GA","examples":[{"title":"Get the query's cursors","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n const cursors = results.cursors;\n}\n"}],"type":{"kind":"REFERENCE","name":"Cursors","referenceFqn":"Cursors"},"description":"Returns the query cursors.\n\n`cursors` returns the query's `next` and `prev` cursors."},{"name":"items","slug":"items","isDeprecated":false,"isInternal":false,"maturity":"GA","examples":[{"title":"Get `items` from a query result","content":"const returnedItems = results.items;\n"},{"title":"Perform a query and get `items` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n const returnedItems = results.items;\n\n if (returnedItems.length > 0) {\n return items;\n } else {\n // Handle if no matching items found\n }\n}\n"}],"type":{"kind":"ARRAY","elementType":{"kind":"REFERENCE","name":"EventGuest","referenceFqn":"EventGuest"}},"description":"Returns an array of `guests` items that match the query.\n\n`items` contains the current page of results retrieved by the query.\nIf no results match the query, `items` is an empty array.\nThe page size is defined by the [`limit()`](wix-events-v2/guests/guests-query-builder#limit) function and can be retrieved using the [`pageSize`](#pagesize) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `guests` to navigate the pages of a query result."},{"name":"length","slug":"length","isDeprecated":false,"isInternal":false,"maturity":"GA","examples":[{"title":"Get `length` from a query result","content":"const resultLength = results.length;\n"},{"title":"Perform a query and get `length` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n return results.length;\n}\n"}],"type":{"kind":"PRIMITIVE","name":"number"},"description":"Returns the number of items in the current page of results.\n\n`length` returns just the number of items in the current page, not the total number of items that match the query. For the total number of items that match the query, see [`totalCount`](#totalcount).\nThe page size is defined by the [`limit()`](wix-events-v2/guests/guests-query-builder#limit) function and can be retrieved using the [`pageSize`](#pagesize) property. You can use the [`next()`](#next) and [`prev()`](#prev) functions returned by `guests` to navigate the pages of a query result."},{"name":"pageSize","slug":"page-size","isDeprecated":false,"isInternal":false,"maturity":"GA","examples":[{"title":"Get the query's page size","content":"const requestedPageSize = results.pageSize;\n"},{"title":"Perform a query and get `pageSize` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n return results.pageSize;\n}\n"}],"type":{"kind":"PRIMITIVE","name":"number"},"description":"Returns the requested page size.\n\n`pageSize` returns the page size set in [`limit()`](wix-events-v2/guests/guests-query-builder#limit) in `GuestsQueryBuilder`."},{"name":"query","slug":"query","isDeprecated":false,"isInternal":false,"maturity":"GA","examples":[{"title":"Get `query` that produced the current result","content":"const originalQuery = results.query;\n"},{"title":"Perform a query and get `query` from the result","content":"import { guests } from 'wix-events.v2';\n\nexport async function myQueryFunction() {\n const results = await guests.queryGuests().find();\n\n return results.query;\n}\n"}],"type":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"description":"Returns the `GuestsQueryBuilder` object used to get the current results.\n\nUse `query` to create and run a new query by chaining additional `GuestsQueryBuilder` functions to it. You can filter only on properties that haven't already been used in the previous `GuestsQueryBuilder`."}]},"QueryEventGuestsOptions":{"name":"QueryEventGuestsOptions","fqn":"QueryEventGuestsOptions","slug":"query-event-guests-options","actions":[],"properties":[{"name":"fields","slug":"fields","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"ARRAY","elementType":{"kind":"REFERENCE","name":"RequestedFieldsEnumRequestedFields","referenceFqn":"RequestedFieldsEnumRequestedFields"}},"description":"Predefined sets of fields to return.\n- `GUEST_DETAILS`: Returns `guestDetails` and `tickets`."}]},"RequestedFieldsEnumRequestedFields":{"name":"RequestedFieldsEnumRequestedFields","fqn":"RequestedFieldsEnumRequestedFields","slug":"requested-fields-enum-requested-fields","actions":[],"enumValues":["GUEST_DETAILS","GUEST_TOTAL","UNKNOWN_REQUESTED_FIELD"],"properties":[]}},"actions":[{"name":"queryGuests","fqn":"queryGuests","slug":"query-guests","isDeprecated":false,"isInternal":false,"isDeveloperPreview":false,"maturity":"GA","permissions":["Read Events - all read permissions","Manage Events - all permissions","Manage Guest List","Read Event Tickets and Guest List"],"permissionsScopesIds":["SCOPE.DC-EVENTS-MEGA.READ-EVENTS","SCOPE.DC-EVENTS-MEGA.MANAGE-EVENTS","SCOPE.DC-EVENTS.MANAGE-GUEST-LIST","SCOPE.DC-EVENTS.READ-GUEST-LIST"],"applicableIdentities":["APP"],"adminMethod":true,"returnType":{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},"examples":[{"title":"Retrieve all guests (dashboard page code) ","description":"","content":"import { guests } from \"wix-events.v2\";\n\n/* Sample options value:\n *\n * {\n * \"fields\": [\"GUEST_DETAILS\"]\n * }\n * \n */\n \nexport async function myQueryGuestsFunction(options) {\n try {\n const items = await guests.queryGuests(options)\n .find()\n console.log('Success! Guests: ', items)\n return items;\n } catch (error) {\n console.error(error);\n // Handle the error\n }\n }\n\n/* Promise resolves to:\n * {\n * \"_items\": [\n * {\n * \"eventId\": \"3a80a30c-643d-4b11-b38f-1150dbe7c538\",\n * \"orderNumber\": \"2SVV-RH7C-P3D\",\n * \"tickets\": [],\n * \"contactId\": \"c64c558f-ed41-4395-b820-f8dd66c31702\",\n * \"guestDetails\": {\n * \"email\": \"johndoe@mail.com\",\n * \"firstName\": \"John\",\n * \"lastName\": \"Doe\",\n * \"formResponse\": {\n * \"inputValues\": [\n * {\n * \"inputName\": \"firstName\",\n * \"value\": \"John\",\n * \"values\": []\n * },\n * {\n * \"inputName\": \"lastName\",\n * \"value\": \"Doe\",\n * \"values\": []\n * },\n * {\n * \"inputName\": \"email\",\n * \"value\": \"johndoe@mail.com\",\n * \"values\": []\n * }\n * ]\n * },\n * \"checkedIn\": true\n * }\n * ],\n * \"_originQuery\": {\n * \"filterTree\": {\n * \"$and\": []\n * },\n * \"invalidArguments\": [],\n * \"encoder\": {},\n * \"transformationPaths\": {},\n * \"sort\": [],\n * \"paging\": {},\n * \"pagingMethod\": \"CURSOR\",\n * \"builderOptions\": {\n * \"cursorWithEmptyFilterAndSort\": true\n * }\n * },\n * \"_limit\": 50,\n * \"_nextCursor\": \"\",\n * \"_prevCursor\": \"\",\n * \"cursors\": {\n * \"next\": \"\",\n * \"prev\": \"\"\n * }\n * }\n * } \n */"},{"title":"Query guests (export from backend code) ","description":"","content":"import { Permissions, webMethod } from 'wix-web-module';\nimport { guests } from \"wix-events.v2\";\nimport { elevate } from 'wix-auth';\n\n/* Sample options value:\n *\n * {\n * \"fields\": [\"GUEST_DETAILS\"]\n * }\n * \n */\n \nexport const myQueryGuestsFunction = webMethod(\n Permissions.Anyone, \n async (options) => {\n try {\n const elevatedQueryGuests = elevate(guests.queryGuests);\n const items = await elevatedQueryGuests(options).find()\n console.log('Success! Guests: ', items)\n return items;\n } catch (error) {\n console.error(error);\n // Handle the error\n }\n });\n\n/* Promise resolves to:\n * {\n * \"_items\": [\n * {\n * \"eventId\": \"3a80a30c-643d-4b11-b38f-1150dbe7c538\",\n * \"orderNumber\": \"2SVV-RH7C-P3D\",\n * \"tickets\": [],\n * \"contactId\": \"c64c558f-ed41-4395-b820-f8dd66c31702\",\n * \"guestDetails\": {\n * \"email\": \"johndoe@mail.com\",\n * \"firstName\": \"John\",\n * \"lastName\": \"Doe\",\n * \"formResponse\": {\n * \"inputValues\": [\n * {\n * \"inputName\": \"firstName\",\n * \"value\": \"John\",\n * \"values\": []\n * },\n * {\n * \"inputName\": \"lastName\",\n * \"value\": \"Doe\",\n * \"values\": []\n * },\n * {\n * \"inputName\": \"email\",\n * \"value\": \"johndoe@mail.com\",\n * \"values\": []\n * }\n * ]\n * },\n * \"checkedIn\": true\n * }\n * ],\n * \"_originQuery\": {\n * \"filterTree\": {\n * \"$and\": []\n * },\n * \"invalidArguments\": [],\n * \"encoder\": {},\n * \"transformationPaths\": {},\n * \"sort\": [],\n * \"paging\": {},\n * \"pagingMethod\": \"CURSOR\",\n * \"builderOptions\": {\n * \"cursorWithEmptyFilterAndSort\": true\n * }\n * },\n * \"_limit\": 50,\n * \"_nextCursor\": \"\",\n * \"_prevCursor\": \"\",\n * \"cursors\": {\n * \"next\": \"\",\n * \"prev\": \"\"\n * }\n * }\n * } \n */"}],"actionParams":[{"name":"options","slug":"options","isDeprecated":false,"isInternal":false,"maturity":"GA","type":{"kind":"REFERENCE","name":"QueryEventGuestsOptions","referenceFqn":"QueryEventGuestsOptions"}}],"description":"Creates a query to retrieve a list of guests.\n\n\nThe `queryGuests()` function builds a query to retrieve a list of guests and returns a [GuestsQueryBuilder](https://www.wix.com/velo/reference/wix-events-v2/guests/guestsquerybuilder) object.\n\nThe returned object contains the query definition which is typically used to run the query using the `find()` function.\n\nYou can refine the query by chaining `GuestsQueryBuilder` functions onto the query. `GuestsQueryBuilder` functions enable you to sort, filter, and control the results that `queryGuests.find()` returns.\n\nThe query runs with the following `GuestsQueryBuilder` defaults that you can override:\n\n- [`skip(0)`](https://www.wix.com/velo/reference/wix-events-v2/guests/guestsquerybuilder/skipto)\n- [`limit(50)`](https://www.wix.com/velo/reference/wix-events-v2/guests/guestsquerybuilder/limit)\n- [`descending(\"_createdDate\")`](https://www.wix.com/velo/reference/wix-events-v2/guests/guestsquerybuilder/descending)\n\nThe functions that are chained to `queryGuests()` are applied in the order they are called. For example, if you apply `ascending ('_createdDate')` and then `descending ('_updatedDate')`, the results are sorted first by the created date and then, if there are multiple results with the same date, the items are sorted by the updated date.\n\nThe table below shows which `GuestsQueryBuilder` functions are supported for `queryGuests()`. You can only use one filter function for each property. Only the first filter will work if a property is used in more than one filter.\n\n\n|PROPERTY\t|SUPPORTED FILTERS & SORTING\t\n|:---:|:---:|\n|`_id`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`eventId`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`rsvpId`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`orderNumber`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`ticketNumber`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`tickets`|[`exists()`](/guests/guests-query-builder/exists)|\n|`contactId`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`guestDetails.checkedIn`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`exists()`](/guests/guests-query-builder/exists)|\n|`attendanceStatus`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in)|\n|`secondaryLanguageCode`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`_createdDate`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`lt()`](/guests/guests-query-builder/lt),[`le()`](/guests/guests-query-builder/le),[`gt()`](/guests/guests-query-builder/gt),[`ge()`](/guests/guests-query-builder/ge),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists),[`ascending()`](/guests/guests-query-builder/ascending),[`descending()`](/guests/guests-query-builder/descending)|\n|`_updatedDate`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`lt()`](/guests/guests-query-builder/lt),[`le()`](/guests/guests-query-builder/le),[`gt()`](/guests/guests-query-builder/gt),[`ge()`](/guests/guests-query-builder/ge),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists),[`ascending()`](/guests/guests-query-builder/ascending),[`descending()`](/guests/guests-query-builder/descending)|\n|`attendanceStatusUpdatedDate`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`lt()`](/guests/guests-query-builder/lt),[`le()`](/guests/guests-query-builder/le),[`gt()`](/guests/guests-query-builder/gt),[`ge()`](/guests/guests-query-builder/ge),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists),[`ascending()`](/guests/guests-query-builder/ascending),[`descending()`](/guests/guests-query-builder/descending)|\n|`memberId`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in),[`exists()`](/guests/guests-query-builder/exists)|\n|`guestType`|[`eq()`](/guests/guests-query-builder/eq),[`ne()`](/guests/guests-query-builder/ne),[`in()`](/guests/guests-query-builder/in)|"}],"webhooks":[],"articles":[{"content":"---\ntitle: Introduction\n---\n# Introduction\n\n> **Note**: This module is [universal](/api-overview/api-versions#universal-modules). Functions in this module can run on both the backend and frontend, unless specified otherwise.\n\nWith the Event Guests API, site owners can get information about all guests who bought tickets to an event or who RSVP'ed. The information includes guest names, email addresses, tickets, RSVP status, and so on. This makes it easier to build custom functionality around event management, such as sending custom notifications to guests, managing event capacity, and generating reports on attendance.\n\nThe Event Guests API allows you to: \n\n* Retrieve a list of guests by event ID.\n* Get information about each individual ticket buyer.\n* Find out the attendance status of each guest.\n\n## Terminology\n\n- **Guest**: The individual who has been invited to the event.\n- **RSVP**: A response from the guest indicating whether they plan to attend the event.\n- **Ticket buyer**: The individual who bought 1 or more tickets to the event.\n- **Check-in**: The process of verifying a guest's attendance at the event.\n- **Guest list**: A summary of all guests who have been invited to the event.\n- **Organizer**: The person or entity responsible for planning and hosting the event.\n\n## Before you begin\n\nIt’s important to note the following points before starting to code: \n\n- To use the Events Guests API, import `{ guests }` from the `wix-events.v2` module:\n\n```javascript\nimport { guests } from 'wix-events.v2';\n```\n\n\n\n","displayName":"Introduction","slugifyName":"introduction"}],"builderTypes":[{"kind":"REFERENCE","name":"GuestsQueryBuilder","referenceFqn":"GuestsQueryBuilder"},{"kind":"REFERENCE","name":"GuestsQueryResult","referenceFqn":"GuestsQueryResult"}],"properties":[],"namespaces":[]}},"reviewStatus":"UNKNOWN","isLocked":false,"metadata":{"packageVersion":"1.0.109"}}