> ## 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

# Vivid Seats event listings and stats

> Returns VividSeats event metadata, the latest summary of listed
inventory, a daily statistics history, and a per-section breakdown of
the latest snapshot.

VividSeats data covers **listed inventory only** — there are no sales
fields. Prices are all-in (fees included) and in the venue market's
currency (`event.currency`). A "price point" is a (section, all-in price)
bucket, not an individual seller listing.

Every summary metric `X` has `X_24h` (signed change versus the most
recent snapshot at least 24 hours older) and `X_24h_percentage`. Both
are `0` until a snapshot that old exists. Check `summary.stats_date`
for freshness.

Decimal amounts are returned as JSON strings to preserve precision.

**Cost:** 1 credit.




## OpenAPI

````yaml /openapi.yaml get /eventory/data/vividseats/{production_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/vividseats/{production_id}:
    get:
      tags:
        - Market Data
      summary: VividSeats event
      description: >
        Returns VividSeats event metadata, the latest summary of listed

        inventory, a daily statistics history, and a per-section breakdown of

        the latest snapshot.


        VividSeats data covers **listed inventory only** — there are no sales

        fields. Prices are all-in (fees included) and in the venue market's

        currency (`event.currency`). A "price point" is a (section, all-in
        price)

        bucket, not an individual seller listing.


        Every summary metric `X` has `X_24h` (signed change versus the most

        recent snapshot at least 24 hours older) and `X_24h_percentage`. Both

        are `0` until a snapshot that old exists. Check `summary.stats_date`

        for freshness.


        Decimal amounts are returned as JSON strings to preserve precision.


        **Cost:** 1 credit.
      operationId: getVividseatsEvent
      parameters:
        - name: production_id
          in: path
          required: true
          description: >-
            VividSeats production id — the number after `/production/` in the
            event URL.
          schema:
            type: string
            pattern: ^\d+$
            example: '6686410'
      responses:
        '200':
          description: Event data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VividseatsResponse'
        '400':
          description: The path id is not all digits.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                status: error
                code: INVALID_VIVIDSEATS_ID
                message: >-
                  Invalid vividseats id 'abc': expected the numeric production
                  id.
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: >-
            No VividSeats data for the production. Parking-pass productions also
            return 404.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                status: error
                code: EVENT_NOT_FOUND
                message: No vividseats data for production 1.
components:
  schemas:
    VividseatsResponse:
      type: object
      properties:
        event:
          $ref: '#/components/schemas/VividseatsEvent'
        summary:
          $ref: '#/components/schemas/VividseatsSummary'
        daily_statistics:
          type: array
          description: >-
            One entry per scraped day (the day's last snapshot), chronological.
            Days without a scrape are absent.
          items:
            $ref: '#/components/schemas/VividseatsDailyStatistic'
        sections:
          type: array
          description: Per-section breakdown of the latest snapshot, most tickets first.
          items:
            $ref: '#/components/schemas/VividseatsSection'
      example:
        event:
          vividseats_event_id: '6686410'
          vividseats_event_url: >-
            https://www.vividseats.com/hamilton-tickets-albuquerque-popejoy-hall-9-12-2027/production/6686410
          event_name: Hamilton
          event_date: '2027-09-12T19:00:00Z'
          event_time_tba: false
          event_date_tba: false
          event_image: https://images.example.com/cover.jpg
          category_name: Hamilton
          currency: USD
          venue:
            name: Popejoy Hall
            city: Albuquerque
            country: USA
            country_code: US
            svg_map_url: null
            timezone: America/Denver
          artist:
            name: Hamilton
            url: >-
              https://www.viagogo.com/Theater-Tickets/Cast-Recordings/Musicals/Hamilton-Tickets
            image_url: null
          external_urls:
            ticketmaster_event_id: null
            ticketmaster_event_url: null
            vividseats_event_id: '6686410'
            vividseats_event_url: >-
              https://www.vividseats.com/hamilton-tickets-albuquerque-popejoy-hall-9-12-2027/production/6686410
        summary:
          stats_date: '2026-10-20T12:27:29Z'
          currency: USD
          available_tickets: 178
          available_tickets_24h: -6
          available_tickets_24h_percentage: '-3.26'
          price_points: 14
          price_points_24h: 0
          price_points_24h_percentage: '0.00'
          average_ticket_price_available: '681.16'
          median_price: '583.00'
          get_in_price: '403.00'
          get_in_price_24h: '12.00'
          get_in_price_24h_percentage: '3.07'
          max_price: '1180.00'
          listed_inventory_value: '121247.00'
        daily_statistics:
          - stat_date: '2026-10-19'
            available_tickets: 184
            price_points: 14
            average_ticket_price_available: '672.40'
            median_price: '580.00'
            get_in_price: '391.00'
            max_price: '1180.00'
            listed_inventory_value: '123722.00'
          - stat_date: '2026-10-20'
            available_tickets: 178
            price_points: 14
            average_ticket_price_available: '681.16'
            median_price: '583.00'
            get_in_price: '403.00'
            max_price: '1180.00'
            listed_inventory_value: '121247.00'
        sections:
          - section_name: BALC LEFT
            zone: Balcony
            is_general_admission: false
            price_points: 2
            available_tickets: 32
            average_price: '686.00'
            min_price: '438.00'
            max_price: '934.00'
          - section_name: ORCH CTR
            zone: Orchestra
            is_general_admission: false
            price_points: 2
            available_tickets: 32
            average_price: '985.00'
            min_price: '825.00'
            max_price: '1145.00'
    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
    VividseatsEvent:
      type: object
      properties:
        vividseats_event_id:
          type: string
          description: The production id requested.
        vividseats_event_url:
          type:
            - string
            - 'null'
        event_name:
          type:
            - string
            - 'null'
        event_date:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            RFC3339, UTC, so its date can differ from the show's local date:
            convert it to `venue.timezone`.
        event_time_tba:
          type:
            - boolean
            - 'null'
          description: >-
            `true` when the start time is not confirmed yet: the time in
            `event_date` is provisional, often a placeholder such as 15:00
            local, and only the local day in `venue.timezone` is reliable.
            `null` when unknown.
        event_date_tba:
          type:
            - boolean
            - 'null'
          description: '`true` when the date is not confirmed either. `null` when unknown.'
        event_image:
          type:
            - string
            - 'null'
        category_name:
          type:
            - string
            - 'null'
        currency:
          type: string
          description: >-
            ISO-4217 code of the venue market (`USD`, `CAD`, `GBP`, `EUR`, ...).
            All prices use it.
        venue:
          oneOf:
            - $ref: '#/components/schemas/Venue'
            - type: 'null'
        artist:
          oneOf:
            - $ref: '#/components/schemas/ArtistRef'
            - type: 'null'
        external_urls:
          $ref: '#/components/schemas/ExternalUrls'
    VividseatsSummary:
      type: object
      description: >-
        Latest snapshot. Each metric has a `_24h` signed change and a
        `_24h_percentage`.
      properties:
        stats_date:
          type: string
          format: date-time
          description: When the snapshot was taken.
        currency:
          type: string
        available_tickets:
          type:
            - integer
            - 'null'
          description: Tickets currently listed.
        available_tickets_24h:
          type:
            - integer
            - 'null'
        available_tickets_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        price_points:
          type:
            - integer
            - 'null'
          description: Distinct (section, price) buckets listed.
        price_points_24h:
          type:
            - integer
            - 'null'
        price_points_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_available:
          $ref: '#/components/schemas/Decimal'
          description: Average all-in ask price per ticket.
        average_ticket_price_available_24h:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_available_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        median_price:
          $ref: '#/components/schemas/Decimal'
          description: Median all-in ask price per ticket.
        median_price_24h:
          $ref: '#/components/schemas/Decimal'
        median_price_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        get_in_price:
          $ref: '#/components/schemas/Decimal'
          description: Cheapest listed ticket.
        get_in_price_24h:
          $ref: '#/components/schemas/Decimal'
        get_in_price_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        max_price:
          $ref: '#/components/schemas/Decimal'
          description: Most expensive listed ticket.
        max_price_24h:
          $ref: '#/components/schemas/Decimal'
        max_price_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        listed_inventory_value:
          $ref: '#/components/schemas/Decimal'
          description: Sum of price x tickets across everything listed.
        listed_inventory_value_24h:
          $ref: '#/components/schemas/Decimal'
        listed_inventory_value_24h_percentage:
          $ref: '#/components/schemas/Decimal'
    VividseatsDailyStatistic:
      type: object
      properties:
        stat_date:
          type: string
          format: date
          description: Calendar day (UTC).
        available_tickets:
          type:
            - integer
            - 'null'
        price_points:
          type:
            - integer
            - 'null'
        average_ticket_price_available:
          $ref: '#/components/schemas/Decimal'
        median_price:
          $ref: '#/components/schemas/Decimal'
        get_in_price:
          $ref: '#/components/schemas/Decimal'
        max_price:
          $ref: '#/components/schemas/Decimal'
        listed_inventory_value:
          $ref: '#/components/schemas/Decimal'
    VividseatsSection:
      type: object
      properties:
        section_name:
          type: string
        zone:
          type:
            - string
            - 'null'
        is_general_admission:
          type:
            - boolean
            - 'null'
        price_points:
          type:
            - integer
            - 'null'
        available_tickets:
          type:
            - integer
            - 'null'
        average_price:
          $ref: '#/components/schemas/Decimal'
        min_price:
          $ref: '#/components/schemas/Decimal'
        max_price:
          $ref: '#/components/schemas/Decimal'
    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
    Venue:
      type: object
      properties:
        name:
          type:
            - string
            - 'null'
        city:
          type:
            - string
            - 'null'
        country:
          type:
            - string
            - 'null'
        country_code:
          type:
            - string
            - 'null'
          description: ISO-3166 alpha-2.
        svg_map_url:
          type:
            - string
            - 'null'
        timezone:
          type:
            - string
            - 'null'
          description: >-
            IANA time zone of the venue, e.g. `Europe/Vienna`. Convert
            `event_date` to it for the local date and time. `null` when unknown.
    ArtistRef:
      type: object
      properties:
        name:
          type:
            - string
            - 'null'
        url:
          type:
            - string
            - 'null'
          description: Pass this value to `GET /eventory/data/artist`.
        image_url:
          type:
            - string
            - 'null'
    ExternalUrls:
      type: object
      description: Cross-marketplace identifiers. Fields are `null` when not on file.
      properties:
        ticketmaster_event_id:
          type:
            - string
            - 'null'
        ticketmaster_event_url:
          type:
            - string
            - 'null'
        vividseats_event_id:
          type:
            - string
            - 'null'
        vividseats_event_url:
          type:
            - string
            - 'null'
    Decimal:
      type:
        - string
        - 'null'
      description: Decimal amount encoded as a string.
      example: '129.50'
  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.
  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.