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

# viagogo event prices and daily stats

> Returns Viagogo event metadata, the latest aggregate summary, the full
daily statistics history, and a price distribution histogram.

**Cost:** 1 credit.

Decimal amounts are returned as JSON strings to preserve precision.




## OpenAPI

````yaml /openapi.yaml get /eventory/data/viagogo/{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/viagogo/{event_id}:
    get:
      tags:
        - Market Data
      summary: Viagogo event
      description: |
        Returns Viagogo event metadata, the latest aggregate summary, the full
        daily statistics history, and a price distribution histogram.

        **Cost:** 1 credit.

        Decimal amounts are returned as JSON strings to preserve precision.
      operationId: getViagogoEvent
      parameters:
        - name: event_id
          in: path
          required: true
          description: Viagogo event identifier including the `E-` prefix.
          schema:
            type: string
            pattern: ^E-\d+$
            example: E-160973997
      responses:
        '200':
          description: Event data.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ViagogoResponse'
        '400':
          description: The path id does not match `E-<digits>`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                status: error
                code: INVALID_VIAGOGO_ID
                message: 'Invalid viagogo id ''160973997'': expected format E-<digits>.'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: No tracked event matches the id.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DataApiError'
              example:
                status: error
                code: EVENT_NOT_FOUND
                message: No viagogo event with id E-1.
        '502':
          $ref: '#/components/responses/DataUpstream'
components:
  schemas:
    ViagogoResponse:
      type: object
      properties:
        event:
          $ref: '#/components/schemas/ViagogoEvent'
        summary:
          $ref: '#/components/schemas/ViagogoSummary'
        daily_statistics:
          type: array
          description: >-
            One entry per calendar day (UTC) with data since the event was first
            tracked, chronological. Days without data are missing.
          items:
            $ref: '#/components/schemas/ViagogoDailyStatistic'
        price_histogram:
          $ref: '#/components/schemas/PriceHistogram'
      example:
        event:
          viagogo_event_id: 160973997
          viagogo_event_url: >-
            https://www.viagogo.com/Concert-Tickets/Rock-and-Pop/Artist-Tickets/E-160973997
          event_name: Artist World Tour
          event_date: '2026-06-15T20:00:00Z'
          event_time_tba: false
          event_date_tba: false
          event_image: https://images.example.com/cover.jpg
          category_name: Concerts
          currency: USD
          venue:
            name: Madison Square Garden
            city: New York
            country: United States
            country_code: US
            svg_map_url: null
            timezone: America/New_York
          artist:
            name: Artist
            url: >-
              https://www.viagogo.com/Concert-Tickets/Rock-and-Pop/Artist-Tickets
            image_url: null
          external_urls:
            ticketmaster_event_id: 0200642CF18CAA24
            ticketmaster_event_url: https://www.ticketmaster.com/event/0200642CF18CAA24
            vividseats_event_id: null
            vividseats_event_url: null
        summary:
          is_general_admission_only: false
          stats_date: '2026-06-12T06:00:00Z'
          tickets_sold: 1840
          tickets_sold_24h: 62
          tickets_sold_24h_percentage: '3.49'
          listings_available: 410
          available_tickets: 1275
          average_ticket_price_sold: '162.40'
          average_ticket_price_available: '201.10'
          highest_sale_price: '980.00'
          get_in_price: '74.00'
          total_volume: '298816.00'
          currency: USD
        daily_statistics:
          - stat_date: '2026-06-11'
            tickets_sold: 1778
            tickets_sold_24h: 51
            available_tickets: 1320
            listings_available: 422
            average_ticket_price_sold: '160.90'
            average_ticket_price_available: '199.30'
            highest_sale_price: '980.00'
          - stat_date: '2026-06-12'
            tickets_sold: 1840
            tickets_sold_24h: 62
            available_tickets: 1275
            listings_available: 410
            average_ticket_price_sold: '162.40'
            average_ticket_price_available: '201.10'
            highest_sale_price: '980.00'
        price_histogram:
          bins: 10
          min: '0'
          max: '1000'
          currency: USD
          data:
            - start: '0'
              end: '100'
              tickets_sold: 412
            - start: '100'
              end: '200'
              tickets_sold: 903
    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
    ViagogoEvent:
      type: object
      properties:
        viagogo_event_id:
          type: integer
          description: Numeric portion of the event id.
        viagogo_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: Dominant sale currency (ISO-4217). `USD` when no sales exist yet.
        venue:
          oneOf:
            - $ref: '#/components/schemas/Venue'
            - type: 'null'
        artist:
          oneOf:
            - $ref: '#/components/schemas/ArtistRef'
            - type: 'null'
        external_urls:
          $ref: '#/components/schemas/ExternalUrls'
    ViagogoSummary:
      type: object
      description: >-
        Latest aggregate snapshot. Every numeric field can be `null` before the
        first stats row exists.
      properties:
        is_general_admission_only:
          type:
            - boolean
            - 'null'
        stats_date:
          type:
            - string
            - 'null'
          format: date-time
        tickets_sold:
          type:
            - integer
            - 'null'
        tickets_sold_24h:
          type:
            - integer
            - 'null'
        tickets_sold_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        listings_sold:
          type:
            - integer
            - 'null'
        listings_sold_24h:
          type:
            - integer
            - 'null'
        listings_sold_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        listings_available:
          type:
            - integer
            - 'null'
        listings_available_24h:
          type:
            - integer
            - 'null'
        listings_available_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        available_tickets:
          type:
            - integer
            - 'null'
        available_tickets_24h:
          type:
            - integer
            - 'null'
        available_tickets_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_sold:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_sold_24h:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_sold_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_available:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_available_24h:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_available_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        highest_sale_price:
          $ref: '#/components/schemas/Decimal'
        highest_sale_price_24h:
          $ref: '#/components/schemas/Decimal'
        highest_sale_price_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        get_in_price:
          $ref: '#/components/schemas/Decimal'
          description: Cheapest available ticket. `null` when nothing is listed.
        get_in_price_24h:
          $ref: '#/components/schemas/Decimal'
          description: >-
            `null` when nothing is listed, or when there is no comparable value
            from 24 hours earlier.
        get_in_price_24h_percentage:
          $ref: '#/components/schemas/Decimal'
          description: '`null` in the same cases as `get_in_price_24h`.'
        total_volume:
          $ref: '#/components/schemas/Decimal'
          description: Total sales volume in `currency`.
        currency:
          type: string
    ViagogoDailyStatistic:
      type: object
      properties:
        stat_date:
          type: string
          format: date
          description: The calendar day the entry covers
          in UTC.: null
        tickets_sold:
          type:
            - integer
            - 'null'
        tickets_sold_24h:
          type:
            - integer
            - 'null'
          description: >-
            Tickets sold during that day: the 24 hours up to the day's last
            update, normally the end of the UTC day.
        available_tickets:
          type:
            - integer
            - 'null'
        listings_available:
          type:
            - integer
            - 'null'
        average_ticket_price_sold:
          $ref: '#/components/schemas/Decimal'
        average_ticket_price_available:
          $ref: '#/components/schemas/Decimal'
        highest_sale_price:
          $ref: '#/components/schemas/Decimal'
    PriceHistogram:
      type: object
      description: >-
        When there are no sales yet, `min` and `max` are `"0"` and `data` is
        empty.
      properties:
        bins:
          type: integer
        min:
          type: string
          example: '0'
        max:
          type: string
          example: '500'
        currency:
          type: string
        data:
          type: array
          items:
            type: object
            properties:
              start:
                type: string
                description: Inclusive lower bound.
              end:
                type: string
                description: Upper bound.
              tickets_sold:
                type: integer
    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.
    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.