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

# List platforms

> Returns the eleven supported platform keys with their accepted regions, the
shape of the `sections` they return, and an example event id. Use it to confirm
the exact `platform` and `event_id` format before calling `POST /events/scrape`.
Several platforms take the full event URL as `event_id`.

**Cost:** 5 credits. Cache the result; the list changes rarely.




## OpenAPI

````yaml /openapi.yaml get /events/platforms
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:
  /events/platforms:
    get:
      tags:
        - Live Availability
      summary: List platforms
      description: >
        Returns the eleven supported platform keys with their accepted regions,
        the

        shape of the `sections` they return, and an example event id. Use it to
        confirm

        the exact `platform` and `event_id` format before calling `POST
        /events/scrape`.

        Several platforms take the full event URL as `event_id`.


        **Cost:** 5 credits. Cache the result; the list changes rarely.
      operationId: listPlatforms
      responses:
        '200':
          description: Platform registry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformsResponse'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    PlatformsResponse:
      type: object
      properties:
        platforms:
          type: object
          description: Keyed by platform identifier.
          additionalProperties:
            type: object
            properties:
              description:
                type:
                  - string
                  - 'null'
                description: What this platform monitors.
              sections_type:
                type: string
                enum:
                  - OfferSections
                  - SeatMapSections
                description: Shape of `sections` in the scrape response.
              regions:
                type:
                  - array
                  - 'null'
                description: >-
                  Accepted region codes. `null` means any value is accepted or
                  ignored.
                items:
                  type: string
              event_id_example:
                type: string
                description: A realistic `event_id` for this platform.
      example:
        platforms:
          axs:
            description: null
            sections_type: SeatMapSections
            regions:
              - uk
              - us
              - nu
              - de
            event_id_example: https://www.axs.com/e/artist-name-tickets-venue/551681
          dice_fm:
            description: null
            sections_type: OfferSections
            regions: null
            event_id_example: https://link.dice.fm/Q3dd78515650
          eventim:
            description: >-
              Eventim — monitors ticket availability across Europe. The correct
              scraping strategy (HTML or performance API) is selected
              automatically based on the event region.
            sections_type: OfferSections
            regions:
              - de
              - it
              - uk
              - fi
              - fr
              - nl
              - 'no'
              - sk
              - es
              - ch
              - se
              - pl
              - dk
              - at
              - si
              - hr
              - ro
              - hu
            event_id_example: https://www.eventim.de/en/tickets/artist-name-venue-12345/
          fansale:
            description: null
            sections_type: OfferSections
            regions:
              - it
            event_id_example: '532635'
          seatgeek:
            description: null
            sections_type: OfferSections
            regions: null
            event_id_example: '18010329'
          stubhub:
            description: >-
              StubHub — monitors resale ticket availability worldwide. UK events
              (stubhub.co.uk) are routed to the dedicated UK monitor
              automatically; all other regions use the global StubHub monitor.
            sections_type: OfferSections
            regions: null
            event_id_example: https://www.stubhub.com/artist-name-venue-tickets/event/1234567
          ticketek:
            description: >-
              Ticketek — monitors ticket availability for events in Australia,
              New Zealand, Singapore, Malaysia, UK, and the Philippines. Region
              is inferred from the event URL domain.
            sections_type: OfferSections
            regions:
              - au
              - nz
              - sg
              - my
              - uk
              - ph
            event_id_example: >-
              https://premier.ticketek.com.au/events/ONKKETEC26/venues/SSD/performances/ESSD2026866EC/tickets
          ticketportal:
            description: Ticketportal — monitors ticket availability for events
            sections_type: OfferSections
            regions:
              - cz
              - sk
            event_id_example: '1462276'
          tickpick:
            description: null
            sections_type: OfferSections
            regions: null
            event_id_example: '1234567'
          tm:
            description: >-
              Ticketmaster — monitors primary and resale ticket availability for
              events worldwide.
            sections_type: SeatMapSections
            regions:
              - us
              - ca
              - uk
              - ie
              - au
              - nz
              - mx
              - de
              - es
              - nl
              - at
              - dk
              - be
              - 'no'
              - ch
              - se
              - fi
              - pl
              - ae
              - cz
              - fr
              - it
              - za
            event_id_example: 0200642CF18CAA24
          viagogo:
            description: null
            sections_type: OfferSections
            regions: null
            event_id_example: https://www.viagogo.com/Concert-Tickets/E-1234567
    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.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: apikey
      description: Your Eventory API key. Sent as the `apikey` request header.

````