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

# Viagogo event

> Returns Viagogo event metadata, the latest aggregate summary, a rolling
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 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/viagogo/{event_id}:
    get:
      tags:
        - Market Data
      summary: Viagogo event
      description: |
        Returns Viagogo event metadata, the latest aggregate summary, a rolling
        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: event_id must look like 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 event with id E-1
        '429':
          $ref: '#/components/responses/RateLimited'
        '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 day in the rolling window, chronological.
          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_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
          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_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
    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.: null
        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.
        get_in_price_24h:
          $ref: '#/components/schemas/Decimal'
        get_in_price_24h_percentage:
          $ref: '#/components/schemas/Decimal'
        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
        tickets_sold:
          type:
            - integer
            - 'null'
        tickets_sold_24h:
          type:
            - integer
            - 'null'
        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 no sales have been observed, `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'
    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: 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.

````