openapi: 3.1.0
info:
  title: Ticketmaster Discovery Attractions Events API
  description: The Ticketmaster Discovery API allows developers to search for events, attractions, venues, and classifications across all Ticketmaster supported sources, markets, and locales. The API provides access to content from Ticketmaster, Universe, FrontGate Tickets, and Ticketmaster Resale platforms.
  version: '2.0'
servers:
- url: https://app.ticketmaster.com/discovery/v2
tags:
- name: Events
  description: Search and retrieve event information.
paths:
  /events.json:
    get:
      operationId: searchEvents
      summary: Search events
      description: Find events and filter the search by location, date, availability, and other criteria.
      tags:
      - Events
      parameters:
      - name: apikey
        in: query
        required: true
        description: API key for authentication.
        schema:
          type: string
      - name: keyword
        in: query
        description: Keyword to search on.
        schema:
          type: string
      - name: city
        in: query
        description: Filter by city name.
        schema:
          type: string
      - name: stateCode
        in: query
        description: Filter by state code.
        schema:
          type: string
      - name: countryCode
        in: query
        description: Filter by country code.
        schema:
          type: string
      - name: startDateTime
        in: query
        description: Filter events starting after this date/time.
        schema:
          type: string
          format: date-time
      - name: endDateTime
        in: query
        description: Filter events starting before this date/time.
        schema:
          type: string
          format: date-time
      - name: size
        in: query
        description: Page size of the response.
        schema:
          type: integer
      - name: page
        in: query
        description: Page number.
        schema:
          type: integer
      responses:
        '200':
          description: Success
  /events/{id}.json:
    get:
      operationId: getEventDetails
      summary: Get event details
      description: Get details for a specific event using the event identifier.
      tags:
      - Events
      parameters:
      - name: id
        in: path
        required: true
        description: Event identifier.
        schema:
          type: string
      - name: apikey
        in: query
        required: true
        description: API key for authentication.
        schema:
          type: string
      responses:
        '200':
          description: Success
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: apikey