# StableTickets API

Base URL: https://stabletickets.dev

StableTickets wraps Ticketmaster Discovery API v2 with x402/MPP pay-per-request access. Callers do not need a Ticketmaster developer account or API key.

Use this API when an agent needs live public Ticketmaster discovery data: events, venues, attractions, classifications, event images, or typeahead-style suggestions. This API does not sell, reserve, or purchase tickets.

## Happy Path

1. Search events with POST /api/events/search. Use countryCode, city, postalCode, geoPoint+radius, startDateTime/endDateTime, classificationName, or keyword to narrow results.
2. Pick an event id from _embedded.events[].id.
3. Call POST /api/events/details with { "id": "..." } for full event, venue, attraction, sales, dates, price range, and purchase URL data.
4. If the user asks for venue context, call POST /api/venues/details with the embedded venue id.

## Endpoint Guide

- POST /api/events/search: Search Ticketmaster events. Prefer this for "concerts near me", "sports in NYC this weekend", and date/location/category queries.
- POST /api/events/details: Get one event by id.
- POST /api/events/images: Get images for one event by id.
- POST /api/attractions/search: Search artists, teams, performers, and other attractions.
- POST /api/attractions/details: Get one attraction by id.
- POST /api/venues/search: Search venues by name, city, state, country, postal code, or geoPoint.
- POST /api/venues/details: Get one venue by id.
- POST /api/classifications/search: Search Ticketmaster segments, genres, and subgenres.
- POST /api/classifications/details: Get one classification by id.
- POST /api/suggest: Fast suggestions across events, attractions, venues, and products.

## Query Notes

Dates use Ticketmaster ISO date-time strings, e.g. "2026-06-01T00:00:00Z". Ticketmaster deep paging only supports the first 1000 items: keep size * page < 1000. Use locale "*" when the caller does not care about locale. Use source only when the caller asks for a specific Ticketmaster source such as ticketmaster, universe, frontgate, or tmr.

## Pricing

All endpoints cost $0.01 per successful call.