The guestlists resource returns a structured response of objects representing tickets for which the authenticated user is the event host. By default, this API returns paginated results for all the objects ever created meeting that requirement - without respect to the specific event, or state of the ticket. Filtering by Listing (the object for which tickets are purchased) or by Event (the specific date of the Listing, which can have many dates). A music festival, for example, may have one Listing with many Events such as Saturday and Sunday.
Note that this API response will return all tickets - including those with a state of cancelled.
A developer wishing to use this resource to synchronize tickets with another system should pay careful attention to the state of each ticket, an enum described below, as well as the event the ticket was purchased for.
In the response, each ticket object will include a state. This may be one of the following possible values
The ticket has been paid, and the funds have been transferred to the host
The ticket has not yet been approved by the host (configurable via a setting)
The ticket is awaiting processing by the payment gateway
The ticket payment has been processed by the gateway, which has not yet confirmed its status
The ticket has been paid using Universe Payments and the event is still in the future, valid
The ticket payment failed, not valid
The ticket has been cancelled, any transaction has been reversed, not valid
The ticket has been paid, the event is in the past, but the funds have not yet been transferred to the host
The ticket was originally failed, and the window for retrying has expired (such as the event being in the past)
A general error state, not valid
The ticket was purchased with a payment plan, and has been partially paid