List Events with Wix Events API

This recipe demonstrates how to query and list events from Wix Events using the REST API.

Prerequisites

• Wix Events app installed on the site
• API access with events permissions

Required APIs

• Events API: REST
• Filter and Sort Guidelines: Documentation

Step 1: Verify Events App is Installed

Before querying events, ensure Wix Events is installed on the site. If not, use the Install Wix Apps recipe to install it.

Step 2: Query Events

Endpoint: POST https://www.wixapis.com/events/v3/events/query

Request Body:

Request:

Available Field Sets

The fields parameter determines which data is returned. You MUST specify at least "DETAILS".

IMPORTANT NOTES:

• I MUST specify at least "DETAILS" in the fields array
• I MUST NEVER use "FULL" as a field value
• If the user wants event links, I MUST include "URLS" in the fields
• Follow the Filter and Sort Guidelines for query filtering

Step 3: Filter Events (Optional)

Apply filters to narrow down results:

Filter by Status:

Filter by Date Range:

Response Structure

Common Use Cases

List Upcoming Events

List Events with Registration Info

Next Steps

• Create events using the Create Event API
• Manage RSVPs and registrations
• Configure event tickets and pricing