> ## 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 recent sales > Returns the most recent individual Viagogo sales for an event, newest first. **Cost:** 1 credit per 20 rows requested, i.e. `ceil(sales_limit / 20)`. Omitting `sales_limit` returns 20 rows for 1 credit; `sales_limit=200` costs 10 credits. A value outside `1..200` is rejected with `400 invalid_parameter` before anything is billed. ## OpenAPI ````yaml /openapi.yaml get /eventory/data/sales/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/sales/viagogo/{event_id}: get: tags: - Market Data summary: Viagogo recent sales description: > Returns the most recent individual Viagogo sales for an event, newest first. **Cost:** 1 credit per 20 rows requested, i.e. `ceil(sales_limit / 20)`. Omitting `sales_limit` returns 20 rows for 1 credit; `sales_limit=200` costs 10 credits. A value outside `1..200` is rejected with `400 invalid_parameter` before anything is billed. operationId: getViagogoSales 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 - name: section in: query required: false description: Only return sales in this section label (exact match). schema: type: string example: Floor - name: sales_limit in: query required: false description: >- Number of rows to return. Default 20. Billed at 1 credit per 20 rows. schema: type: integer minimum: 1 maximum: 200 default: 20 responses: '200': description: Recent sales. content: application/json: schema: $ref: '#/components/schemas/SalesResponse' '400': description: Invalid event id, or `sales_limit` out of range. content: application/json: schema: oneOf: - $ref: '#/components/schemas/DataApiError' - $ref: '#/components/schemas/GatewayError' examples: bad_limit: summary: sales_limit out of range (rejected by the gateway) value: error: code: invalid_parameter message: sales_limit must be between 1 and 200. bad_id: summary: Malformed event id value: status: error code: INVALID_VIAGOGO_ID message: event_id must look like E- '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' '429': $ref: '#/components/responses/RateLimited' '502': $ref: '#/components/responses/DataUpstream' components: schemas: SalesResponse: type: object properties: sales: type: array items: $ref: '#/components/schemas/Sale' example: sales: - listing_id: '9876543' section: Floor row: C seat: '12' sold_tickets: 2 raw_price: '210.00' created_datetime: '2026-04-27T18:32:11Z' - listing_id: '9876212' section: Floor row: F seat: null sold_tickets: 1 raw_price: '185.00' created_datetime: '2026-04-27T17:05:40Z' 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 Sale: type: object properties: listing_id: oneOf: - type: string - type: integer - type: 'null' section: type: - string - 'null' row: type: - string - 'null' seat: type: - string - 'null' sold_tickets: type: integer raw_price: $ref: '#/components/schemas/Decimal' description: Per-ticket price. created_datetime: type: - string - 'null' format: date-time 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. ````