Guide / Reference

REST API

Enterprise includes a key for the REST API and the MCP server. Every route below is on the live dataset and returns JSON with stable IDs. The full OpenAPI document is served by the API itself; this list is generated from it.

Base URL and key come with the Enterprise plan. Send the key as a bearer token. The MCP server exposes the same data as tools for Claude Desktop, Claude Code, Cursor and custom agents; the console's MCP page has the configuration to paste.

  1. venues
  2. events
  3. artists
  4. search
  5. metrics
  6. states
  7. reference
  8. media

venues

MethodRouteWhat it returns
GET/v1/venuesList & filter venues (busiest-first by default)
GET/v1/venues/{venue_id}Full venue profile
GET/v1/venues/{venue_id}/eventsShows at a venue
GET/v1/venues/{venue_id}/similarComparable rooms in the same region/type

events

MethodRouteWhat it returns
GET/v1/eventsList & filter events
GET/v1/events/{event_id}Full event detail with resolved venue and line-up
GET/v1/events/{event_id}/artistsLine-up for one event

artists

MethodRouteWhat it returns
GET/v1/artistsList & filter the artist directory
GET/v1/artists/{artist_id}Full artist profile
GET/v1/artists/{artist_id}/eventsBooking history for an act
MethodRouteWhat it returns
GET/v1/searchCross-type search grouped by record type
GET/v1/search/suggestLightweight typeahead

metrics

MethodRouteWhat it returns
GET/v1/metrics/marketMarket KPI snapshot
GET/v1/metrics/artistsArtist-market rollup
GET/v1/metrics/venues/{venue_id}Per-venue scorecard
GET/v1/metrics/cadenceDay-of-week & seasonal timing
GET/v1/metrics/insights/nationalCross-state pricing & coverage
GET/v1/metrics/artists/multi-stateActs touring two or more states

states

MethodRouteWhat it returns
GET/v1/statesState registry with counts & data levels

reference

MethodRouteWhat it returns
GET/v1/reference/{vocab}Filter vocabulary terms

media

MethodRouteWhat it returns
GET/v1/media/tracksPreview tracks + artwork for an artist
GET/v1/media/artworkCached artwork-only lookup