Find event tickets

Help the buyer choose an event and understand the ticket offer before they pay.

Find the event

If the buyer supplied an event link, open that link. Otherwise, ask for the event name or their preferred location and dates.
Read the public event listing at https://www.ticketfairy.com/api/v1/events/listing with the filters below. It requires no sign-in. Start with page=1&size=20&sort=start_date&order=asc.
Read data.events and use each event's url, displayName, startDate, endDate, timezone and venue to select relevant candidates. data.pagination gives page, size, totalCount, totalPages and nextCursor. When you need more results, send nextCursor as the cursor parameter with the same filters. Stop when nextCursor is null. An empty result is not proof that a private or unlisted event does not exist; ask the buyer for its official link.

Filter	How to use it
`search`	Optional name search, 2 to 120 characters. It matches the event, organiser or venue name, not the city or state. URL-encode the value. Do not use `q`.
`country`	Optional two-letter country code, such as `gb`, `au` or `id`.
`state`	Optional exact state value, up to 100 characters. For a city request, use country and date filters, then compare each returned `venue.city`. Do not assume a city name matches `search`.
`section_type`	Use `upcoming` for future or still-running events when the buyer has no date range. Use `none` for an explicit date range. Other section types ignore `from` and `to`.
`from`, `to`, `timezone`	With `section_type=none`, these bound the event's start time, inclusively, in the specified IANA timezone. Resolve relative dates with the buyer and use explicit local timestamps such as `2027-04-10 00:00:00` and `2027-04-11 23:59:59`, with `timezone=Europe/London`. URL-encode timestamps and timezone. These filters do not include an event that started before `from` but is still running; check `upcoming` and the returned start/end times when the buyer wants overlapping events.
`page`, `size`	Page numbers start at 1. Use a small page such as 20; the maximum size is 200. Stop after sufficient relevant results rather than downloading the whole catalogue.
`cursor`	The `nextCursor` value from the previous response. It sets the page and the page size. Send the same filters with it.