> ## Documentation Index > Fetch the complete documentation index at: /docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Base URL: https://api.eventory.ai. Send your API key in the apikey header. Market Data and Live Availability calls cost credits, pings included; GET /usage is free, so use it to test a key. Costs per endpoint: https://eventory.ai/docs/credits-and-access.md # Ticketmaster event inventory and prices > Returns Ticketmaster event data (scrape runs, per-section snapshot stats, statistics history), the latest aggregate stats, and the dashboard chart payload. The three blocks are fetched in parallel. `scrapeRuns` and `statisticsHistory` are sorted newest first and trimmed to `limit`. `sectionStats` has one row per section, from the most recent scrape run only. `offerStats` is currently always empty. The inner shapes are stable but additive: new keys may appear without notice. Every price is a number in the venue's local currency, as Ticketmaster lists it. The `currency` on each row or object names it, and it is the same across the whole response. Percentages are strings such as `"5.25"`, except in `dashboard_v2`, where they are numbers. **Cost:** 1 credit. ## OpenAPI ````yaml /openapi.yaml get /eventory/data/ticketmaster/{tm_event_id} openapi: 3.1.0 info: title: Eventory API version: '1.0' description: > Every HTTP endpoint of the Eventory platform, reached through the single public gateway at `https://api.eventory.ai`. The Notifications API is a WebSocket and is documented separately under **Notifications API**. Authenticate every request with the `apikey` header. Each endpoint lists its credit cost; see **Credits & access** for how billing works. contact: name: Eventory url: https://eventory.ai servers: - url: https://api.eventory.ai description: Production security: - apiKey: [] tags: - name: Market Data description: | Historical and aggregated marketplace data for events and artists, plus full-text search over the Eventory catalog. Polling API. **1 credit per request** (sales list scales with rows requested). - name: Live Availability description: > On-demand scrape of the current ticket availability for one event on one of the twelve supported platforms. **5 credits per request.** - name: Watchlist description: | Manage the events your account monitors. The watchlist drives the Notifications API. **Free.** - name: Account description: Your plan and credit usage, live from billing. **Free.** paths: /eventory/data/ticketmaster/{tm_event_id}: get: tags: - Market Data summary: Ticketmaster event description: > Returns Ticketmaster event data (scrape runs, per-section snapshot stats, statistics history), the latest aggregate stats, and the dashboard chart payload. The three blocks are fetched in parallel. `scrapeRuns` and `statisticsHistory` are sorted newest first and trimmed to `limit`. `sectionStats` has one row per section, from the most recent scrape run only. `offerStats` is currently always empty. The inner shapes are stable but additive: new keys may appear without notice. Every price is a number in the venue's local currency, as Ticketmaster lists it. The `currency` on each row or object names it, and it is the same across the whole response. Percentages are strings such as `"5.25"`, except in `dashboard_v2`, where they are numbers. **Cost:** 1 credit. operationId: getTicketmasterEvent parameters: - name: tm_event_id in: path required: true description: Ticketmaster event id as it appears in the event URL. schema: type: string pattern: ^[A-Za-z0-9_-]{1,64}$ example: 0200642CF18CAA24 - name: limit in: query required: false description: >- Maximum entries in `scrapeRuns`, `statisticsHistory`, and the dashboard chart series. schema: type: integer minimum: 1 maximum: 1000 default: 100 responses: '200': description: Ticketmaster event data. content: application/json: schema: $ref: '#/components/schemas/TicketmasterResponse' '400': description: The path id is not 1 to 64 letters, digits, `-` or `_`. content: application/json: schema: $ref: '#/components/schemas/DataApiError' example: status: error code: INVALID_TICKETMASTER_ID message: >- Invalid ticketmaster id 'abc.def': expected 1-64 letters, digits, '-' or '_'. '401': $ref: '#/components/responses/Unauthenticated' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '404': description: >- The id is not tracked by Eventory, or it is linked to an event Eventory has no Ticketmaster data for yet. content: application/json: schema: $ref: '#/components/schemas/DataApiError' example: status: error code: EVENT_NOT_FOUND message: No tracked ticketmaster event with id '0200642CF18CAA24'. '502': $ref: '#/components/responses/DataUpstream' components: schemas: TicketmasterResponse: type: object properties: ticketmaster_event: type: object properties: scrapeRuns: type: array description: Newest first, trimmed to `limit`. items: type: object additionalProperties: true properties: region: type: string created_date_time: type: string format: date-time sectionStats: type: array description: One row per section, from the most recent scrape run only. items: type: object additionalProperties: true properties: section_name: type: string seatmap_id: type: - string - 'null' capacity: type: - integer - 'null' is_general_admission: type: - boolean - 'null' created_date_time: type: string format: date-time currency: type: string offers: type: array description: > One entry per offer type in the section, with that offer type's `available_stock` and `sold_amount`. The average prices, fees included, are the section's and the same on every entry; `null` when nothing in the section is priced. items: type: object additionalProperties: true properties: offer_type: type: - string - 'null' available_stock: type: string sold_amount: type: string average_price_total: type: - number - 'null' average_price_resale: type: - number - 'null' average_price_primary: type: - number - 'null' currency: type: string created_date_time: type: string format: date-time offerStats: type: array description: Currently always empty. items: type: object additionalProperties: true properties: offer_name: type: string offer_stock: type: integer average_price_fees: type: number average_price_no_fees: type: number offer_type: type: integer currency: type: string created_date_time: type: string format: date-time statisticsHistory: type: array description: Newest first, trimmed to `limit`. items: type: object additionalProperties: true properties: tickets_sold: type: integer tickets_sold_24h: type: integer tickets_sold_24h_percentage: type: string available_tickets: type: integer created_date_time: type: string format: date-time highest_price: type: number lowest_price: type: number average_ticket_price_available: type: number average_ticket_price_standard: type: number average_ticket_price_resell: type: number average_ticket_price_platinum: type: number capacity: type: integer currency: type: string latest_stats: type: object additionalProperties: true properties: tickets_sold: type: integer available_tickets: type: integer currency: type: string dashboard_v2: type: object additionalProperties: true properties: currency: type: string current_values: type: object additionalProperties: true properties: average_sales_price: type: number description: >- Average price of the standard tickets on sale, not of tickets sold. highest_sale_price: type: number description: Highest ticket price on sale, not a sale price. listing_available: type: number description: >- Resale tickets on sale, counted in tickets rather than listings. average_tickets_per_sale: type: number description: Not computed; always `0`. charts: type: object description: Parallel arrays indexed by `timestamps`. additionalProperties: true properties: timestamps: type: array items: type: string example: ticketmaster_event: scrapeRuns: - region: US created_date_time: '2026-06-12T05:00:00Z' sectionStats: - section_name: '101' seatmap_id: manifest_section_0 capacity: 250 is_general_admission: false created_date_time: '2026-06-12T05:00:00Z' currency: USD offers: - offer_type: Standard:Admission_101 available_stock: '33' sold_amount: '217' average_price_total: 104.5 average_price_resale: 120 average_price_primary: 95 currency: USD created_date_time: '2026-06-12T05:00:00Z' offerStats: [] statisticsHistory: - tickets_sold: 200 tickets_sold_24h: 15 tickets_sold_24h_percentage: '8.11' available_tickets: 320 created_date_time: '2026-06-12T05:00:00Z' highest_price: 180 lowest_price: 45 average_ticket_price_available: 97 average_ticket_price_standard: 88 average_ticket_price_resell: 120 average_ticket_price_platinum: 150 capacity: 520 currency: USD latest_stats: tickets_sold: 1000 available_tickets: 550 currency: USD dashboard_v2: currency: USD current_values: total_tickets_sold: 1000 tickets_sold_last_24h: 40 tickets_sold_last_24h_percentage: 4.1 available_tickets: 550 available_tickets_delta_percentage: -1.3 listing_available: 120 average_sales_price: 98 average_listing_price: 105 get_in_price: 48 charts: timestamps: - '2026-06-11' - '2026-06-12' total_tickets_sold: - 960 - 1000 tickets_sold_last_24h: - 32 - 40 available_tickets: - 610 - 550 listing_available: - 150 - 120 average_listing_price: - 99 - 105 get_in_price: - 44 - 48 DataApiError: type: object description: Error envelope of the Market Data API. required: - status - code - message properties: status: type: string const: error code: type: string enum: - INVALID_VIAGOGO_ID - INVALID_VIVIDSEATS_ID - INVALID_TICKETMASTER_ID - INVALID_REQUEST - INVALID_FILTER - MISSING_URL - EVENT_NOT_FOUND - ARTIST_NOT_FOUND message: type: string GatewayError: type: object description: > Envelope for every failure decided by the gateway (auth, ACL, billing, rate limit, unknown route, upstream 5xx). Key on `code`; `message` is prose and may change. required: - error properties: error: type: object required: - code - message properties: code: type: string enum: - unauthenticated - invalid_credentials - forbidden - no_subscription - limit_reached - no_billing_account - plan_unavailable - payment_required - invalid_parameter - rate_limited - not_found - service_unavailable message: type: string responses: Unauthenticated: description: No credential was sent, or the key was rejected. content: application/json: schema: $ref: '#/components/schemas/GatewayError' examples: missing: value: error: code: unauthenticated message: Authentication is required to access this resource. invalid: value: error: code: invalid_credentials message: Your credentials are invalid or expired. PaymentRequired: description: Billing denied the request. See `code`. content: application/json: schema: $ref: '#/components/schemas/GatewayError' examples: limit: value: error: code: limit_reached message: You have reached your usage limit. subscription: value: error: code: no_subscription message: Your account has no active subscription. Forbidden: description: >- The key is valid but not granted this route. Contact support to enable it. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: code: forbidden message: You do not have access to this service. DataUpstream: description: >- The Market Data API failed or timed out. The gateway keeps the status (`500`, `502`, `503` or `504`) and answers with its own envelope; the underlying error is not forwarded. Retry with backoff. content: application/json: schema: $ref: '#/components/schemas/GatewayError' example: error: code: service_unavailable message: The service is temporarily unavailable. securitySchemes: apiKey: type: apiKey in: header name: apikey description: Your Eventory API key. Sent as the `apikey` request header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.