Guestlists

Authentication required

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

Language
Credentials
OAuth2
Click Try It! to start a request and see the response here!