> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eventory.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ticketmaster event

> Returns Ticketmaster event data (scrape runs, per-section and per-offer
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` and `offerStats` contain only the rows of the
most recent scrape run.

The inner shapes are stable but additive: new keys may appear without notice.

**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 real-time notification stream is a

    WebSocket and is documented separately under **Real-time stream**.


    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 eleven supported platforms. **5 credits per request.**
  - name: Watchlist
    description: |
      Manage the events your account monitors. The watchlist drives the
      real-time stream. **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 and per-offer

        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` and `offerStats` contain only the rows of the

        most recent scrape run.


        The inner shapes are stable but additive: new keys may appear without
        notice.


        **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
            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'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: The id is not tracked by Eventory.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                status: error
                code: EVENT_NOT_FOUND
                message: No tracked ticketmaster event with id '0200642CF18CAA24'.
        '429':
          $ref: '#/components/responses/RateLimited'
        '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: Rows of the most recent scrape run only.
              items:
                type: object
                additionalProperties: true
                properties:
                  section_name:
                    type: string
                  capacity:
                    type: string
                  available_stock:
                    type: string
                  sold_amount:
                    type: string
                  created_date_time:
                    type: string
                    format: date-time
            offerStats:
              type: array
              description: Rows of the most recent scrape run only.
              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
                  available_tickets:
                    type: integer
                  created_date_time:
                    type: string
                    format: date-time
                  highest_price:
                    type: string
                  lowest_price:
                    type: string
                  average_ticket_price_available:
                    type: string
                  average_ticket_price_standard:
                    type: string
                  average_ticket_price_resell:
                    type: string
                  average_ticket_price_platinum:
                    type: string
                  capacity:
                    type: integer
                  currency:
                    type: string
        latest_stats:
          type: object
          additionalProperties: true
          properties:
            tickets_sold:
              type: integer
            available_tickets:
              type: integer
        dashboard_v2:
          type: object
          additionalProperties: true
          properties:
            currency:
              type: string
            current_values:
              type: object
              additionalProperties: true
            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'
              capacity: '250'
              available_stock: '33'
              sold_amount: '217'
              created_date_time: '2026-06-12T05:00:00Z'
          offerStats:
            - offer_name: Standard
              offer_stock: 120
              average_price_fees: 110
              average_price_no_fees: 95
              offer_type: 0
              currency: USD
              created_date_time: '2026-06-12T05:00:00Z'
          statisticsHistory:
            - tickets_sold: 200
              tickets_sold_24h: 15
              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
        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: '0'
            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_REQUEST
            - MISSING_URL
            - EVENT_NOT_FOUND
            - ARTIST_NOT_FOUND
            - BAD_UPSTREAM_REQUEST
            - UPSTREAM_AUTH_FAILED
            - EDGE_UPSTREAM_ERROR
            - EDGE_UNAVAILABLE
            - EDGE_TIMEOUT
            - INTERNAL_ERROR
        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: The provided credentials are invalid.
    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: 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 resource.
    RateLimited:
      description: More than 30 requests in the current minute. Back off.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/GatewayError'
          example:
            error:
              code: rate_limited
              message: Rate limit exceeded.
    DataUpstream:
      description: >-
        The data backend rejected the request, failed, or timed out.
        `INTERNAL_ERROR`, `EDGE_UNAVAILABLE`, and `EDGE_TIMEOUT` are safe to
        retry once with backoff.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/DataApiError'
          example:
            status: error
            code: EDGE_UPSTREAM_ERROR
            message: Upstream returned an unexpected payload
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: Your Eventory API key. Sent as the `apikey` request header.

````