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

State	Description
closed	The ticket has been paid, and the funds have been transferred to the host
unapproved	The ticket has not yet been approved by the host (configurable via a setting)
unpaid	The ticket is awaiting processing by the payment gateway
pending	The ticket payment has been processed by the gateway, which has not yet confirmed its status
paid	The ticket has been paid using Universe Payments and the event is still in the future, valid
failed	The ticket payment failed, not valid
cancelled	The ticket has been cancelled, any transaction has been reversed, not valid
ended	The ticket has been paid, the event is in the past, but the funds have not yet been transferred to the host
expired	The ticket was originally failed, and the window for retrying has expired (such as the event being in the past)
error	A general error state, not valid
partially_paid	The ticket was purchased with a payment plan, and has been partially paid