JamBase Events API

openapi: 3.2.0
info:
  description: REST API for concerts, festivals, artists, and venues featuring normalized data from JamBase.
  version: 3.1.0
  title: JamBase Concert Data Artists Events API
  contact:
    email: developer@jambase.com
    name: Team JamBase
    url: /contact
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  termsOfService: https://www.jambase.com/terms
  summary: REST API for live music data from JamBase
servers:
- url: https://api.data.jambase.com/v3
  description: JamBase Concert Data API
security:
- BearerAuth: []
tags:
- name: Events
  description: Search Events
paths:
  /events:
    get:
      tags:
      - Events
      summary: Search Events
      operationId: searchEvents
      description: 'Search events by location, date, artist, genre, and more.

        '
      parameters:
      - $ref: '#/components/parameters/pageParam'
      - $ref: '#/components/parameters/perPageParam'
      - $ref: '#/components/parameters/eventTypeParam'
      - $ref: '#/components/parameters/eventIdParam'
      - $ref: '#/components/parameters/eventNameParam'
      - $ref: '#/components/parameters/artistIdParam'
      - $ref: '#/components/parameters/artistNameParam'
      - $ref: '#/components/parameters/genreSlugParam'
      - $ref: '#/components/parameters/venueIdParam'
      - $ref: '#/components/parameters/venueNameParam'
      - $ref: '#/components/parameters/geoCityIdParam'
      - $ref: '#/components/parameters/geoCountryIso2Param'
      - $ref: '#/components/parameters/geoCountryIso3Param'
      - $ref: '#/components/parameters/geoIpParam'
      - $ref: '#/components/parameters/geoLatitudeParam'
      - $ref: '#/components/parameters/geoLongitudeParam'
      - $ref: '#/components/parameters/geoMetroIdParam'
      - $ref: '#/components/parameters/geoRadiusAmountParam'
      - $ref: '#/components/parameters/geoRadiusUnitsParam'
      - $ref: '#/components/parameters/geoStateIsoParam'
      - $ref: '#/components/parameters/datePresetParam'
      - $ref: '#/components/parameters/dateFromParam'
      - $ref: '#/components/parameters/dateToParam'
      - in: query
        name: eventDataSource
        description: The EventDataSource of for the Event.
        schema:
          $ref: '#/components/schemas/enumEventDataSource'
      - $ref: '#/components/parameters/dateModifiedFromParam'
      - $ref: '#/components/parameters/datePublishedFromParam'
      - $ref: '#/components/parameters/expandExternalIdentifiersParam'
      - $ref: '#/components/parameters/expandArtistSameAsParam'
      - $ref: '#/components/parameters/expandPastEventsParam'
      - $ref: '#/components/parameters/sortEventsParam'
      - $ref: '#/components/parameters/excludeEventPerformersParam'
      responses:
        '200':
          $ref: '#/components/responses/searchEventsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
  /events/id/{eventDataSource}:{eventId}:
    get:
      tags:
      - Events
      summary: Get / reverse-lookup an Event by JamBase or third-party ID
      operationId: getUpcomingEvent
      description: 'Retrieve a specific Event by JamBase or third-party ID

        '
      parameters:
      - in: path
        name: eventDataSource
        description: The eventDataSource of the ID for the Event.
        required: true
        schema:
          $ref: '#/components/schemas/enumEventDataSource'
      - in: path
        name: eventId
        description: The unique ID for the Event.
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/expandExternalIdentifiersParam'
      - $ref: '#/components/parameters/expandArtistSameAsParam'
      - $ref: '#/components/parameters/excludeEventPerformersParam'
      responses:
        '200':
          $ref: '#/components/responses/getSingleUpcomingEventResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
components:
  schemas:
    enumEventDataSource:
      type: string
      description: Data source slugs to use for Event IDs
      enum:
      - axs
      - dice
      - etix
      - eventbrite
      - eventim-de
      - jambase
      - seated
      - see-tickets
      - see-tickets-uk
      - sofar-sounds
      - seatgeek
      - suitehop
      - ticketmaster
      - tixr
      - viagogo
      x-tags:
      - Enums
    propLatitude:
      title: propLatitude
      type: number
      format: float
      minimum: -90
      maximum: 90
      example: 40.7505
      description: The latitude of a location
      x-stoplight:
        id: 0gf3yu2lypo1r
    PriceSpecification:
      title: PriceSpecification
      description: The price or price range for the thing
      type: object
      required:
      - price
      - priceCurrency
      properties:
        '@type':
          type: string
          enum:
          - PriceSpecification
        minPrice:
          description: The lowest price if the price is a range
          type: number
          format: decimal
          min: 0
          example: 15.99
        maxPrice:
          description: The highest price if the price is a range
          type: number
          format: decimal
          min: 0
          example: 35.99
        price:
          description: The singular price if not a range, same as `minPrice` if a range
          type: number
          format: decimal
          min: 0
          example: 35.99
        priceCurrency:
          type: string
          format: iso-4217
          description: The currency of the price in ISO 4217 format [[docs](https://en.wikipedia.org/wiki/ISO_4217)]
          example: USD
    Organization:
      title: Organization
      description: 'An organization or business.\

        Typically a ticket vendor or data source in this API.\

        The `identifier` or "slug" can also be used as `ticket[vendor][id]` in `/events` and `/livestreams` search endpoints.

        '
      type: object
      required:
      - name
      - identifier
      - disambiguatingDescription
      - datePublished
      - dateModified
      allOf:
      - type: object
        properties:
          '@type':
            type: string
            enum:
            - Organization
          identifier:
            type: string
            description: A unique identifier of the item
            example: ticketmaster
          disambiguatingDescription:
            type: string
            examples:
            - eventTicketVendorPrimary
            - eventTicketVendorSecondary
            - streamTicketVendorPrimary
            - streamDataSource
            - eventDataSource
            - artistDataSource
            - venueDataSource
      - $ref: '#/components/schemas/Thing'
    Success:
      name: success
      description: A successful response.
      type: boolean
      default: true
    enumEventType:
      type: string
      description: The type of event being requested
      enum:
      - concerts
      - festivals
      x-tags:
      - Enums
    enumDatePresets:
      type: string
      description: 'Presets for frequently used date ranges.

        '
      enum:
      - today
      - tomorrow
      - thisWeekend
      - nextWeekend
      - halloween
      - newYears
      - july4th
      x-tags:
      - Enums
    enumVenueDataSource:
      type: string
      description: Data source slugs to use for Venue IDs
      enum:
      - axs
      - dice
      - etix
      - eventbrite
      - eventim-de
      - jambase
      - seated
      - seatgeek
      - suitehop
      - ticketmaster
      - viagogo
      x-stoplight:
        id: vg16q2jczs7fg
      x-tags:
      - Enums
    enumEventStatus:
      type: string
      description: The scheduling status for the event
      enum:
      - scheduled
      - postponed
      - rescheduled
      - cancelled
      x-tags:
      - Enums
    enumCountryIso3:
      type: string
      format: iso-3166-alpha-3
      example: USA
      description: 'The Country code in ISO 3166-1 alpha-3 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)].

        '
      enum:
      - ABW
      - AFG
      - AGO
      - AIA
      - ALB
      - AND
      - ARE
      - ARG
      - ARM
      - ASM
      - ATF
      - ATG
      - AUS
      - AZE
      - BDI
      - BEL
      - BEN
      - BFA
      - BGD
      - BGR
      - BHR
      - BHS
      - BIH
      - BLM
      - BLR
      - BLZ
      - BMU
      - BOL
      - BRA
      - BRB
      - BRN
      - BTN
      - BWA
      - CAF
      - CAN
      - CCK
      - CHE
      - CHL
      - CHN
      - CIV
      - CMR
      - COD
      - COG
      - COK
      - COL
      - COM
      - CPV
      - CRI
      - CUB
      - CUW
      - CXR
      - CYM
      - CYP
      - CZE
      - DEU
      - DJI
      - DMA
      - DNK
      - DOM
      - DZA
      - ECU
      - EGY
      - ERI
      - ESH
      - ESP
      - EST
      - ETH
      - FIN
      - FJI
      - FLK
      - FRA
      - FRO
      - FSM
      - GAB
      - GBR
      - GEO
      - GGY
      - GHA
      - GIB
      - GIN
      - GLP
      - GMB
      - GNB
      - GNQ
      - GRC
      - GRD
      - GRL
      - GTM
      - GUF
      - GUM
      - GUY
      - HKG
      - HND
      - HRV
      - HTI
      - HUN
      - IDN
      - IMN
      - IND
      - IOT
      - IRL
      - IRN
      - IRQ
      - ISL
      - ISR
      - ITA
      - JAM
      - JEY
      - JOR
      - JPN
      - KAZ
      - KEN
      - KGZ
      - KHM
      - KIR
      - KNA
      - KOR
      - KWT
      - LAO
      - LBN
      - LBR
      - LBY
      - LCA
      - LIE
      - LKA
      - LSO
      - LTU
      - LUX
      - LVA
      - MAC
      - MAF
      - MAR
      - MCO
      - MDA
      - MDG
      - MDV
      - MEX
      - MHL
      - MKD
      - MLI
      - MLT
      - MMR
      - MNE
      - MNG
      - MNP
      - MOZ
      - MRT
      - MSR
      - MTQ
      - MUS
      - MWI
      - MYS
      - MYT
      - NAM
      - NCL
      - NER
      - NFK
      - NGA
      - NIC
      - NIU
      - NLD
      - NOR
      - NPL
      - NRU
      - NZL
      - OMN
      - PAK
      - PAN
      - PCN
      - PER
      - PHL
      - PLW
      - PNG
      - POL
      - PRI
      - PRK
      - PRT
      - PRY
      - PYF
      - QAT
      - REU
      - ROU
      - RUS
      - RWA
      - SAU
      - SDN
      - SEN
      - SGP
      - SGS
      - SHN
      - SLB
      - SLE
      - SLV
      - SMR
      - SOM
      - SPM
      - SRB
      - SSD
      - STP
      - SUR
      - SVK
      - SVN
      - SWE
      - SWZ
      - SXM
      - SYC
      - SYR
      - TCA
      - TCD
      - TGO
      - THA
      - TJK
      - TKL
      - TKM
      - TLS
      - TON
      - TTO
      - TUN
      - TUR
      - TUV
      - TWN
      - TZA
      - UGA
      - UKR
      - URY
      - USA
      - UZB
      - VCT
      - VEN
      - VGB
      - VIR
      - VNM
      - VUT
      - WLF
      - WSM
      - XGZ
      - XKS
      - XPR
      - XQZ
      - XSP
      - XSV
      - XWB
      - XXD
      - YEM
      - ZAF
      - ZMB
      - ZWE
      x-tags:
      - Enums
    enumGenres:
      type: string
      description: Music genres
      summary: Multiple genres
      enum:
      - bluegrass
      - blues
      - christian
      - classical
      - country-music
      - edm
      - folk
      - hip-hop-rap
      - indie
      - jamband
      - jazz
      - kpop
      - latin
      - metal
      - pop
      - punk
      - reggae
      - rhythm-and-blues-soul
      - rock
      - tribute
      x-tags:
      - Enums
    Festival:
      title: Festival
      description: A music festival
      type: object
      required:
      - '@type'
      - name
      - identifier
      - url
      - eventStatus
      - startDate
      - endDate
      - location
      - performer
      - x-lineupDisplayOption
      allOf:
      - $ref: '#/components/schemas/Event'
      - type: object
        properties:
          '@type':
            type: string
            enum:
            - Festival
          deletionStatus:
            $ref: '#/components/schemas/propDeletionStatus'
          deletedAt:
            $ref: '#/components/schemas/propDeletedAt'
          mergedInto:
            $ref: '#/components/schemas/propMergedInto'
          x-lineupDisplayOption:
            $ref: '#/components/schemas/enumFestivalLineupDisplayOption'
    enumFestivalLineupDisplayOption:
      type: string
      default: full
      description: Whether to display the `full` lineup or a `daybyday` breakdown
      enum:
      - full
      - daybyday
      x-stoplight:
        id: hfetwdodwtcz5
      x-tags:
      - Enums
    MusicVenue:
      title: MusicVenue
      description: A place to Go See Live Music
      type: object
      allOf:
      - $ref: '#/components/schemas/Thing'
      - type: object
        properties:
          deletionStatus:
            $ref: '#/components/schemas/propDeletionStatus'
          deletedAt:
            $ref: '#/components/schemas/propDeletedAt'
          mergedInto:
            $ref: '#/components/schemas/propMergedInto'
          maximumAttendeeCapacity:
            type: number
            format: int32
            example: 20789
            description: The total number of individuals that may attend an event or venue.
          address:
            $ref: '#/components/schemas/PostalAddress'
          geo:
            $ref: '#/components/schemas/GeoCoordinates'
          events:
            type: array
            items:
              oneOf:
              - $ref: '#/components/schemas/Concert'
              - $ref: '#/components/schemas/Festival'
          x-isPermanentlyClosed:
            type: boolean
            default: false
            description: If the venue is permanently closed.
          x-numUpcomingEvents:
            type: number
            format: int32
            example: 12
            description: The number of upcoming events at this venue.
          x-externalIdentifiers:
            type: array
            items:
            - $ref: '#/components/schemas/ExternalIdentifier'
    ExternalIdentifier:
      title: ExternalIdentifier
      description: A third-party non-JamBase ID for an artist, venue, or event.
      type: object
      properties:
        '@type':
          type: string
          enum:
          - ExternalIdentifier
        source:
          oneOf:
          - $ref: '#/components/schemas/enumEventDataSource'
          - $ref: '#/components/schemas/enumArtistDataSource'
          - $ref: '#/components/schemas/enumVenueDataSource'
        identifier:
          type: string
          description: The unique identifier of the item from the third-party source.
      examples:
      - '@type': ExternalIdentifier
        source: ticketmaster
        identifier: e3asdf3ad
      - '@type': ExternalIdentifier
        source: axs
        identifier: '123423'
    propDeletedAt:
      title: propDeletedAt
      type: string
      format: iso-8601
      example: '2026-04-12T18:01:00Z'
      description: 'The moment the record left the catalog, in ISO 8601. Present only on tombstone rows (see `deletionStatus`). Equals the row''s `dateModified` so the same `dateModifiedFrom` watermark that catches updates also catches the removal.

        '
    enumUrlType:
      type: string
      x-stoplight:
        id: cf4040b56ddd2
      description: The type of the external URL
      enum:
      - officialSite
      - facebook
      - twitter
      - instagram
      - youtube
      - musicbrainz
      - spotify
      - androidApp
      - iosApp
      x-tags:
      - Enums
    Pagination:
      title: Pagination
      description: Enclosure for pagination values.
      type: object
      properties:
        page:
          type: integer
          description: The current page of results.
          example: 1
          minimum: 0
        perPage:
          type: integer
          description: Number of events per page of results.
          example: 10
          minimum: 1
        totalItems:
          type: integer
          description: Total results for the request.
          example: 50
          minimum: 0
        totalPages:
          type: integer
          description: Total pages for the request.
          example: 5
          minimum: 0
        nextPage:
          type: string
          format: url
          description: The absolute URL for the next page of results, if available (e.g. `https://api.data.jambase.com/v3/events?page=2`).
        previousPage:
          type: string
          format: url
          description: The absolute URL for the previous page of results, if available (e.g. `https://api.data.jambase.com/v3/events?page=1`).
    State:
      title: State
      description: 'A State, Region, or Province.

        \

        Note 1: Available for United States, Canada, and Australia only.

        \

        Note 2: The `country` and `x-numUpcomingEvents` nodes are only provided in the Geography lookup endpoints, not as part of `addressRegion` within a Concert, Festival, or Stream.

        '
      type: object
      x-stoplight:
        id: rbp08k99t5o7m
      properties:
        '@type':
          type: string
          enum:
          - State
        identifier:
          $ref: '#/components/schemas/enumState'
        name:
          type: string
          example: Arizona
          description: The name of the State
        alternateName:
          type: string
          example: AZ
          description: The indentifier without the Country code prefix
        country:
          $ref: '#/components/schemas/Country'
          description: 'The country in which the state belongs.

            \

            Note: this is only provided in the Geography lookup endpoints, not as part of a location''s `addressCountry` within a Concert, Festival, or Stream.

            '
        x-numUpcomingEvents:
          type: number
          format: int32
          example: 12
          description: 'The number of upcoming events in this State.

            \

            Note: this is only provided in the Geography lookup endpoints, not as part of a location within a Concert, Festival, or Stream.

            '
    propDeletionStatus:
      title: propDeletionStatus
      type: string
      enum:
      - deleted
      - trashed
      - merged
      example: deleted
      description: 'Present ONLY on tombstone rows returned by delta polls of the core feeds (i.e. requests that include `dateModifiedFrom`). Marks a record that has left the catalog so a long-lived mirror can drop or redirect it:

        - `deleted` — permanently removed.

        - `trashed` — soft-deleted (events only; recoverable upstream). Treat the same as `deleted` in your cache.

        - `merged` — folded into another record; follow `mergedInto`.

        \

        A tombstone row carries only `@type`, `identifier`, `deletionStatus`, `deletedAt`, `dateModified`, and (when `merged`) `mergedInto` — no other fields. Tombstones count toward `perPage` and `pagination.totalItems` and are appended after the live rows in the merged result sequence. Retention: `deleted` / `trashed` tombstones are emitted for 90 days after `deletedAt`; `merged` tombstones never expire. Queries WITHOUT `dateModifiedFrom` never return tombstones.

        '
    GeoCoordinates:
      title: GeoCoordinates
      description: The latitude and longitude for a place
      type: object
      properties:
        '@type':
          type: string
          enum:
          - GeoCoordinates
        latitude:
          $ref: '#/components/schemas/propLatitude'
        longitude:
          $ref: '#/components/schemas/propLongitude'
    Stream:
      title: Stream
      description: A stream
      type: object
      required:
      - '@type'
      - name
      - identifier
      - url
      - eventStatus
      - startDate
      - location
      - performer
      allOf:
      - $ref: '#/components/schemas/Event'
      - type: object
        properties:
          '@type':
            type: string
            enum:
            - Stream
          deletionStatus:
            $ref: '#/components/schemas/propDeletionStatus'
          deletedAt:
            $ref: '#/components/schemas/propDeletedAt'
          mergedInto:
            $ref: '#/components/schemas/propMergedInto'
          isLiveBroadcast:
            type: boolean
            description: True if the broadcast is of a live event
          broadcastOfEvent:
            type: array
            items:
              oneOf:
              - $ref: '#/components/schemas/Concert'
              - $ref: '#/components/schemas/Festival'
          x-customTitle:
            type: string
            description: To replace the default `event[name]` property
      x-stoplight:
        id: fijmf4s5a9h9x
    Country:
      title: Country
      description: A Country.
      type: object
      properties:
        '@type':
          type: string
          enum:
          - Country
        identifier:
          $ref: '#/components/schemas/enumCountryIso2'
        name:
          type: string
          example: United States
          description: The name of the Country Area
        alternateName:
          $ref: '#/components/schemas/enumCountryIso3'
        x-numUpcomingEvents:
          type: number
          format: int32
          example: 12
          description: 'The number of upcoming events in this Country.

            \

            Note: this is only provided in the Geography lookup endpoints, not as part of a location within a Concert, Festival, or Stream.

            '
    PostalAddress:
      title: PostalAddress
      description: A postal address, typically for a MusicVenue
      type: object
      properties:
        '@type':
          type: string
          enum:
          - PostalAddress
        streetAddress:
          type: string
          example: 4 Pennsylvania Plaza
          description: The street address
        addressLocality:
          type: string
          example: New York
          description: The city/locality in which the place is in
        postalCode:
          type: string
          example: '10001'
          description: The postal code
        addressRegion:
          allOf:
          - $ref: '#/components/schemas/State'
        addressCountry:
          allOf:
          - $ref: '#/components/schemas/Country'
        x-streetAddress2:
          type: string
          example: Second Floor
          description: An optional second line for street address.
        x-timezone:
          type: string
          description: 'A "tz database" timezone [[see list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)].

            '
          example: America/New_York
        x-jamBaseMetroId:
          type: number
          format: int32
          example: 1
          description: A unique identifier to the JamBase metro.
        x-jamBaseCityId:
          type: number
          format: int32
          example: 4223296
          description: A unique identifier to the JamBase city.
    Offer:
      title: Offer
      description: Something for sale, typically a concert ticket
      type: object
      required:
      - identifier
      - url
      - category
      - seller
      - validFrom
      allOf:
      - $ref: '#/components/schemas/Thing'
      - type: object
        properties:
          identifier:
            type: string
            description: A unique identifier of the item
            example: jambase:194164
          url:
            type: string
            format: uri
            description: URL of the item
          category:
            type: string
            description: The category of the Offer, typically used to identify a primary or secondary ticketing link
            examples:
            - ticketingLinkPrimary
            - ticketingLinkSecondary
          priceSpecification:
            $ref: '#/components/schemas/PriceSpecification'
          seller:
            $ref: '#/components/schemas/Organization'
            required: true
          validFrom:
            example: '2022-12-07T12:42:00'
            schema:
              type: string
              format: dateTime
    enumRadiusUnits:
      type: string
      description: The units of measure for a geo search radius
      enum:
      - mi
      - km
      x-tags:
      - Enums
    enumCountryIso2:
      type: string
      format: iso-3166-alpha-2
      example: US
      description: 'The Country code in ISO 3166-1 alpha-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)].

        '
      enum:
      - AD
      - AE
      - AF
      - AG
      - AI
      - AL
      - AM
      - AO
      - AR
      - AS
      - AT
      - AU
      - AW
      - AZ
      - BA
      - BB
      - BD
      - BE
      - BF
      - BG
      - BH
      - BI
      - BJ
      - BL
      - BM
      - BN
      - BO
      - BR
      - BS
      - BT
      - BW
      - BY
      - BZ
      - CA
      - CC
      - CD
      - CF
      - CG
      - CH
      - CI
      - CK
      - CL
      - CM
      - CN
      - CO
      - CR
      - CU
      - CV
      - CW
      - CX
      - CY
      - CZ
      - DE
      - DJ
      - DK
      - DM
      - DO
      - DZ
      - EC
      - EE
      - EG
      - EH
      - ER
      - ES
      - ET
      - FI
      - FJ
      - FK
      - FM
      - FO
      - FR
      - GA
      - GB
      - GD
      - GE
      - GF
      - GG
      - GH
      - GI
      - GL
      - GM
      - GN
      - GP
      - GQ
      - GR
      - GS
      - GT
      - GU
      - GW
      - GY
      - HK
      - HN
      - HR
      - HT
      - HU
      - ID
      - IE
      - IL
      - IM
      - IN
      - IO
      - IQ
      - IR
      - IS
      - IT
      - JE
      - JM
      - JO
      - JP
      - KE
      - KG
      - KH
      - KI
      - KM
      - KN
      - KP
      - KR
      - KW
      - KY
      - KZ
      - LA
      - LB
      - LC
      - LI
      - LK
      - LR
      - LS
      - LT
      - LU
      - LV
      - LY
      - MA
      - MC
      - MD
      - ME
      - MF
      - MG
      - MH
      - MK
      - ML
      - MM
      - MN
      - MO
      - MP
      - MQ
      - MR
      - MS
      - MT
      - MU
      - MV
      - MW
      - MX
      - MY
      - MZ
      - NA
      - NC
      - NE
      - NF
      - NG
      - NI
      - NL
      - 'NO'
      - NP
      - NR
      - NU
      - NZ
      - OM
      - PA
      - PE
      - PF
      - PG
      - PH
      - PK
      - PL
      - PM
      - PN
      - PR
      - PT
      - PW
      - PY
      - QA
      - RE
      - RO
      - RS
      - RU
      - RW
      - SA
      - SB
      - SC
      - SD
      - SE
      - SG
      - SH
      - SI
      - SK
      - SL
      - SM
      - SN
      - SO
      - SR
      - SS
      - ST
      - SV
      - SX
      - SY
      - SZ
      - TC
      - TD
      - TF
      - TG
      - TH
      - TJ
      - TK
      - TL
      - TM
      - TN
      - TO
      - TR
      - TT
      - TV
      - TW
      - TZ
      - UA
      - UG
      - US
      - UY
      - UZ
      - VC
      - VE
      - VG
      - VI
      - VN
      - VU
      - WF
      - WS
      - XD
      - XG
      - XK
      - XP
      - XR
      - XS
      - XW
      - YE
      - YT
      - ZA
      - ZM
      - ZW
      x-stoplight:
        id: 1ef0ob0u4hu6w
      x-tags:
      - Enums
    enumArtistDataSource:
      type: string
      description: Data source slugs to use for Artist IDs
      enum:
      - axs
      - dice
      - etix
      - eventbrite
      - eventim-de
      - jambase
      - seated
      - seatgeek
      - spotify
      - ticketmaster
      - viagogo
      - musicbrainz
      default: jambase
      x-stoplight:
        id: m7pyhha21d3n6
      x-tags:
      - Enums
    propLongitude:
      title: propLongitude
      type: number
      format: float
      minimum: -180
      maximum: 180
      example: -73.9934
      description: The longitude of a location
      x-stoplight:
        id: udrk05v1mvsv9
    Thing:
      title: Thing
      description: A generic thing
      type: object
      properties:
        name:
          type: string
          description: The name of the item
        identifier:
          type: string
          example: jambase:194164
          description: A unique identifier of the item
        url:
          type: string
          format: uri
          description: URL of the item
        image:
          type: string
          format: uri
          description: 'An image of the item.\

            \

            Please note that ''image'' may not be provided for all Schemas that include `Thing` (e.g. `Organization`)

            '
        sameAs:
          type: array
          items:
            $ref: '#/components/schemas/URL'
          description: URL of a reference Web page that unambiguously indicates the item's identity
        datePublished:
          type: string
          format: iso-8601
          example: '2022-12-14T15:35:48Z'
          description: 'The date the Event first appeared in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)]

            \

            Please note that ''datePublished'' may not be provided for all Schemas that include `Thing` (e.g. `Organization`)

            '
        dateModified:
          type: string
          format: iso-8601
          example: '2022-12-14T03:41:20Z'
          description: 'The date the Event was last updated in ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)]

            \

            Please note that ''dateModified'' may not be provided for all Schemas that include `Thing` (e.g. `Organization`).

            \

            Indexing timestamps for Concert / Festival / Stream / MusicGroup / MusicVenue live on `datePublished` and `dateModified`. The sibling `x-createdOnDate` and `x-updatedOnDate` fields are scoped to data-source / `Organization` responses (e.g. ticket vendors, performance-rights organizations) and are not present on Event-derived schemas.

            '
    enumAttendanceMode:
      type: string
      default: offline
      description: Indicates whether it occurs online, offline, or a mix.
      enum:
      - mixed
      - offline
      - online
      x-tags:
      - Enums
    Event:
      title: Event
      description: 'A generic event.Please note that `startDate`,`endDate`,`previousStartDate`, and `doorTime` are all returned based on the venue''s local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions.

        '
      type: object
      allOf:
      - $ref: '#/components/schemas/Thing'
        properties:
          sameAs:
            description: Only available for `Festival` type events, not `Concert`
      - type: object
        properties:
          eventStatus:
            $ref: '#/components/schemas/enumEventStatus'
          startDate:
            type: string
            format: iso-8601
            description: 'The start date and time of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)]

              \

              Please note that `startDate` is returned based on the venue''s local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions.

              '
          endDate:
            type: string
            format: iso-8601
            description: 'The end date of the item using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)]

              \

              Please note that `endDate` is returned based on the venue''s local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions.

              '
          previousStartDate:
            type: string
            format: iso-8601
            description: 'For rescheduled events, the previously scheduled start date using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)]

              \

              Please note that `previousStartDate` is returned based on the venue''s local time but without an offset. You can find the timezone at `event > location > address > x-timezone` if you need to do any conversions.

              '
          doorTime:
            type: string
            format: iso-8601
            description: 'The time admission will commence in local time using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_

# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jambase/refs/heads/main/openapi/jambase-events-api-openapi.yml