Build with Ticket Fairy

Example response

{
  "data": {
    "events": [
      {
        "url": "https://www.ticketfairy.com/event/sunset-festival",
        "displayName": "Sunset Festival",
        "startDate": "2027-01-10T12:00:00+11:00",
        "timezone": "Australia/Melbourne",
        "startingPrice": { "amount": "49.00", "currency": "AUD" },
        "venue": { "name": "Beach Park", "city": "Melbourne", "country": "au" }
      }
    ],
    "pagination": { "page": 1, "size": 20, "totalCount": 48, "totalPages": 3, "nextCursor": "eyJ2Ijox..." }
  },
  "success": true,
  "error": false,
  "message": "Events successfully fetched.",
  "status": 200
}

Parameters

Pagination

Each response has a pagination object. To get the next page, send its nextCursor value as the cursor parameter, with the same filters. When nextCursor is null, there are no more pages.

$ curl 'https://www.ticketfairy.com/api/v1/events/listing?search=festival&section_type=upcoming&sort=start_date&order=asc&cursor=NEXT_CURSOR'

Rate limits

Each client address can send 120 requests a minute to the event API. Every response has the RateLimit-Policy header, for example "default";q=120;w=60, and the RateLimit header, for example "default";r=119;t=60. r is the number of requests left and t is the number of seconds until the limit resets. When the limit is used up, the response is 429 with a Retry-After header.

Errors

An error response has success false, a plain-language message, and a code to branch on.

Versions

The version is in the path. Version 1 changes only by addition, so your client must ignore response fields that it does not know. Read the versioning and deprecation policy to see how we announce a retirement.

Get the answer as JSON

$ curl 'https://www.ticketfairy.com/ask?query=jazz+in+Melbourne'

Words such as tonight, this weekend or next month limit the answer to events running then. Send timezone, for example timezone=America/New_York, to read those dates in your timezone. Ask about at most 6 things at once.

The answer has _meta and a results list. Each result has the event's url, name, a short description and a schema.org Event in schema_object.

Get the answer as a stream

Set prefer.streaming to true, or send streaming=true. The answer comes as Server-Sent Events: one start event, one result event for each event found, and one complete event.

$ curl -N 'https://www.ticketfairy.com/ask' \
  -H 'Content-Type: application/json' \
  -d '{"query": {"text": "jazz in Melbourne"}, "prefer": {"streaming": true}, "meta": {"version": "0.55"}}'

event: start
data: {"_meta": {"response_type": "answer", "version": "0.55", ...}, "streaming": true}

event: result
data: {"index": 0, "item": {"url": "...", "name": "...", "schema_object": {"@type": "Event", ...}}}

event: complete
data: {"_meta": {"version": "0.55"}, "count": 1}

Public MCP server

https://www.ticketfairy.com/agentic/mcp is an MCP server over Streamable HTTP. It has one tool, search_events, and a view that shows the results as event cards in clients that support MCP Apps. Each client address can send 120 requests a minute.

{
  "mcpServers": {
    "ticketfairy-events": {
      "type": "http",
      "url": "https://www.ticketfairy.com/agentic/mcp"
    }
  }
}

Agent2Agent

The agent card describes the A2A endpoint and its event search skill.

Manage your own events from an AI assistant

To let an assistant create events, change ticket types or read your orders, use the Ticket Fairy MCP server in the command-line tool. It runs on your own computer and signs in as you.

• OpenAPI description Every parameter, response field, error and header of the public event API, in OpenAPI 3.1.
• Versioning and deprecation policy What stays stable in v1, and how a retirement is announced with the Deprecation and Sunset headers.
• API catalog The RFC 9727 list of the APIs this site serves.
• MCP server card The public MCP server, its tool and its event cards view.
• A2A agent card The Agent2Agent card for public event search.
• Agent skills Ready-made instructions for finding event tickets and for starting to organise events.
• auth.md How an agent registers and gets a credential for anything beyond public reads.
• llms.txt A short index of the platform for language models.