JamBase Events API

Search Events

OpenAPI Specification

jambase-events-api-openapi.yml Raw ↑
openapi: 3.1.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:
  parameters:
    expandPastEventsParam:
      in: query
      name: expandPastEvents
      description: 'Use `true` to include past/historical `Concert` and `Festival` objects.

        \

        When searching events, must be combined with `artistId` or `venueId` parameter.

        \

        Note: The `expandPastEvents` parameter requires that your apikey has the `expandPastEvents` enhancement turned on. Please contact JamBase to request access to this feature.

        '
      schema:
        type: boolean
        default: false
    geoCountryIso2Param:
      in: query
      name: geoCountryIso2
      description: 'The two-letter ISO code for a country.

        - geoCountryIso2=US


        Use a pipe (|) to include multiple countries.

        - geoCountryIso2=US|CA

        '
      schema:
        $ref: '#/components/schemas/enumCountryIso2'
    dateFromParam:
      in: query
      name: eventDateFrom
      description: 'For `concerts` must start on or after this date.\

        For `festivals`, must start on or after this date.\

        If left blank or omitted, will use the current date.\

        The `expandPastEvents` parameter is required when using `eventDateFrom` before the current date.


        - eventDateFrom=2023-10-31


        Note: Dates use <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339</a> format.

        '
      example: '2023-10-01'
      schema:
        type: string
        format: date
    geoLongitudeParam:
      in: query
      name: geoLongitude
      description: 'The longitude for geographic radius.

        - geoLongitude=-73.9934

        '
      schema:
        $ref: '#/components/schemas/propLongitude'
    geoCountryIso3Param:
      in: query
      name: geoCountryIso3
      description: 'The three-letter ISO code for a country.

        - geoCountryIso3=USA


        Use a pipe (|) to include multiple countries.

        - geoCountryIso3=USA|CAN

        '
      schema:
        $ref: '#/components/schemas/enumCountryIso3'
    geoStateIsoParam:
      in: query
      name: geoStateIso
      description: 'The State code in ISO_3166-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-2)].

        - geoStateIso=US-NY


        Use a pipe (|) to include multiple State codes.

        - geoStateIso=US-NY|=US-PA


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

        '
      schema:
        $ref: '#/components/schemas/enumState'
    artistIdParam:
      in: query
      name: artistId
      description: "The source and unique identifier for the artist(s).\\\n\\\nFor example to search for LCD Soundsystem events:\n\n- artistId=jambase:228924\n\nUse a pipe (|) to include multiple artist IDs.\\\n\\\nFor example to search for LCD Soundsystem & Khalid events:\n- artistId=jambase:228924|jambase:3074545\n\nTo use non-JamBase data sources, use the ArtistDataSource [[enum](#)] for the ID(s) you are using.\\\n\\\nFor example to search for LCD Soundsystem events using their Ticketmaster ID:\n  - artistId=ticketmaster:K8vZ9175st0\n"
      schema:
        type: string
        example: jambase:228924
    eventTypeParam:
      in: query
      name: eventType
      description: 'Used to isolate only concerts or only festivals(s)\

        Leave blank to include both concerts and festivals

        - eventType=concert

        - eventType=festival

        '
      schema:
        $ref: '#/components/schemas/enumEventType'
    genreSlugParam:
      in: query
      name: genreSlug
      description: 'Restrict results to a genre.

        - genreSlug=bluegrass


        Use a pipe (|) to include results from multiple genres.

        - genreSlug=bluegrass|blues

        '
      schema:
        $ref: '#/components/schemas/enumGenres'
    datePublishedFromParam:
      in: query
      name: datePublishedFrom
      description: 'Must have been first published on or after this dateTime in GMT.\

        \

        If left blank or omitted, will use all first published on dates.


        - datePublishedFrom=2022-01-01 00:00:00


        Note: Use <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339</a> format for parameter values.

        '
      example: '2022-01-01 00:00:00'
      schema:
        type: string
        format: rfc3339
    geoLatitudeParam:
      in: query
      name: geoLatitude
      description: 'The latitude for geographic radius.

        - geoLatitude=40.7505

        '
      schema:
        $ref: '#/components/schemas/propLatitude'
    geoMetroIdParam:
      in: query
      name: geoMetroId
      description: 'Use to retrieve events for specific <a href="https://apidocs.jambase.com/docs/jambase-api/5b89026bb2462-get-metros">metro ID(s)</a>.

        - geoMetroId=jambase:1


        Use a pipe (|) to include multiple metro IDs.

        - geoMetroId=jambase:1|jambase:5

        '
      example: jambase:1
      schema:
        type: string
    perPageParam:
      in: query
      name: perPage
      description: Number of events per page of results
      required: false
      schema:
        type: integer
        default: 40
        minimum: 1
        maximum: 100
    dateToParam:
      in: query
      name: eventDateTo
      description: 'For `concerts` must start on or before this date.\

        For `festivals` must end on or before this date.\

        If left blank or omitted, will return all events after `eventDateFrom`.


        - eventDateTo=2023-12-31


        Note: Dates use <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339</a> format.

        '
      example: '2023-12-31'
      schema:
        type: string
        format: date
    dateModifiedFromParam:
      in: query
      name: dateModifiedFrom
      description: 'Must have been updated on or after this dateTime in GMT.\

        If left blank or omitted, will use all updated on dates


        - dateModifiedFrom=2022-10-31 00:00:00


        Note: Use <a href="https://www.rfc-editor.org/rfc/rfc3339#section-5.6">RFC3339</a> format for parameter values.

        '
      example: '2022-10-31 00:00:00'
      schema:
        type: string
        format: rfc3339
    venueNameParam:
      in: query
      name: venueName
      description: 'A keyword-based search for venue name(s).

        - venueName=Brooklyn%20Bowl


        Use a pipe (|) to include multiple venue IDs.

        - venueName=Brooklyn%20Bowl|House%20of%20Blues


        For more precise venue-specific results try using `venueId` or `venue[slug]`.

        '
      example: Brooklyn%20Bowl
      schema:
        type: string
    datePresetParam:
      in: query
      name: eventDatePreset
      description: "Use a dynamic date preset.\n- eventDatePreset=tomorrow\n\nNotes: \n- The `eventDatePreset` will override `eventDateFrom` & `eventDateTo` if those are set as well.\n- The `halloween` preset returns events on 10/31 only. The `newYears` preset returns events on 12/31 only. The `july4th` preset returns events on or near July 4th.\n"
      example: tomorrow
      schema:
        $ref: '#/components/schemas/enumDatePresets'
    sortEventsParam:
      in: query
      name: sort
      description: 'Sort order for the returned events.

        \

        - `eventDate` — ascending by event date (oldest first). This is the default.

        \

        - `-eventDate` — descending by event date (most recent first).

        \

        The leading `-` indicates descending order, following the [JSON:API](https://jsonapi.org/format/#fetching-sorting) convention.

        \

        Most useful when combined with `expandPastEvents=true` to retrieve an artist''s or venue''s most recent shows first without paginating through their full history.

        '
      schema:
        type: string
        enum:
        - eventDate
        - -eventDate
        default: eventDate
    artistNameParam:
      in: query
      name: artistName
      description: 'A keyword-based search for artist name(s).

        - artistName=Billie%20Eilish


        Use a pipe (|) to include multiple artist names.

        - artistName=Billie%20Eilish|Lucy%20Dacus


        Keywords should be URL Encoded.\

        For more precise artist-specific results try using `artistId` or `artist[slug]`.


        Please note that `artistName` cannot be used togehter with `artistId` type searches and will be ignored if `artistId` is provided.

        '
      example: Billie Eilish
      schema:
        type: string
    eventIdParam:
      in: query
      name: eventId
      description: 'Restrict the result set to a specific list of Event IDs.\

        \

        For example to fetch a single event:

        - eventId=jambase:16013248


        Use a pipe (|) to include multiple event IDs (recommended form, consistent with `artistId` and `venueId`):

        - eventId=jambase:16013248|jambase:14331594


        A URL-encoded JSON array of IDs is also accepted for compatibility with the v1 `eventId` parameter:

        - eventId=%5B%22jambase%3A16013248%22%2C%22jambase%3A14331594%22%5D


        To use non-JamBase data sources, use the EventDataSource [[enum](#)] for the ID(s) you are using.

        '
      schema:
        type: string
        example: jambase:16013248|jambase:14331594
    pageParam:
      in: query
      name: page
      description: Page number of results to retrieve
      required: false
      schema:
        type: integer
        default: 1
    eventNameParam:
      in: query
      name: name
      description: 'A keyword-based search across event titles (e.g. festival names, special-billing show titles). Resolved server-side against the JamBase title-search index; combined as AND with any other filters (`artistId`, `geoCityId`, dates, etc.). Returns an empty list when nothing matches. Search-tier failures are treated as no matches, never as a 5xx.

        - name=Bonnaroo

        - name=Phish%20New%20Year

        '
      example: Bonnaroo
      schema:
        type: string
    venueIdParam:
      in: query
      name: venueId
      description: 'The source and unique identifier for the venue(s)

        - venueId=jambase:62108


        Use a pipe (|) to include multiple venue IDs

        - venueId=jambase:62108|jambase:7932731


        To use non-JamBase IDs, use the <a href="https://apidocs.jambase.com/docs/jambase-api/vg16q2jczs7fg-enum-venue-data-source">source slug</a> for the ID(s) you are using

        - venueId=ticketmaster:k7vGF99ORYpnS

        '
      example: jambase:62108
      schema:
        type: string
    geoCityIdParam:
      in: query
      name: geoCityId
      description: "Use to retrieve events for specific <a href=\"https://apidocs.jambase.com/docs/jambase-api/5474ac2525de2-search-cities\">JamBase city ID(s)</a>   .     \n- geoCityId=jambase:4223296\n\nUse a pipe (|) to include multiple city IDs.\n- geoCityId=jambase:4223296|jambase:4224564\n\nWhen using the `geoCityId` parameter, you can omit the the `geoRadiusAmount` parameter (or) set it to `0` (or) leave it empty to include only results from the city. Else, you can use a radius amount to include events within a radius around the city-center.\n"
      example: jambase:4223296
      schema:
        type: string
    expandArtistSameAsParam:
      in: query
      name: expandArtistSameAs
      description: 'Use `true` to include `sameAs` (i.e. links) for `Artist` responses.

        '
      schema:
        type: boolean
        default: false
    excludeEventPerformersParam:
      in: query
      name: excludeEventPerformers
      description: 'Use `true` to suppress the `performer` node in `Concert` and `Festival` objects.

        '
      schema:
        type: boolean
        default: false
    geoRadiusAmountParam:
      in: query
      name: geoRadiusAmount
      description: 'The search radius for lat/lng type searches.

        - geoRadiusAmount=60

        '
      schema:
        type: number
        format: int32
        minimum: 1
        maximum: 5000
        default: 60
    geoRadiusUnitsParam:
      in: query
      name: geoRadiusUnits
      description: 'Whether to use miles (default) or kilometers for radius.

        - geoRadiusUnits=km

        '
      schema:
        $ref: '#/components/schemas/enumRadiusUnits'
    geoIpParam:
      in: query
      name: geoIp
      description: 'Use to retrieve events near an IP address.\

        Supports IPv4 or IPv6 values.

        - geoIp=55.123.456.789

        '
      schema:
        oneOf:
        - type: string
          format: ipv4
        - type: string
          format: ipv6
    expandExternalIdentifiersParam:
      in: query
      name: expandExternalIdentifiers
      description: 'Use `true` to include external IDs for `Concert`, `Artist`, and `Venue` objects.

        \

        Note: The `expandExternalIdentifiers` parameter requires that your apikey has the `expandExternalIdentifiers` enhancement turned on. Please contact JamBase to request access to this feature.

        '
      schema:
        type: boolean
        default: false
  schemas:
    propLatitude:
      title: propLatitude
      type: number
      format: float
      minimum: -90
      maximum: 90
      example: 40.7505
      description: The latitude of a location
      x-stoplight:
        id: 0gf3yu2lypo1r
    URL:
      title: URL
      x-stoplight:
        id: ac90d6bc4bf17
      description: A third-party link.
      type: object
      properties:
        '@type':
          type: string
          enum:
          - URL
        identifier:
          $ref: '#/components/schemas/enumUrlType'
        url:
          type: string
          format: uri
          description: The URL of the external link.
    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'
    Request:
      title: Request
      description: Enclosure for request details.
      type: object
      properties:
        endpoint:
          type: string
          format: url
          description: The base endpoint requested
        method:
          type: string
          description: The request method (e.g. GET, POST)
        params:
          type: array
          items: {}
          format: string
          description: The parameters for the request
        ip:
          oneOf:
          - type: string
            format: ipv4
          - type: string
            format: ipv6
          description: The requesting IP address, IPv4 or IPv6
        userAgent:
          type: string
          format: string
          description: The requesting UserAgent
    propMergedInto:
      title: propMergedInto
      type: string
      example: jambase:5632389
      description: 'On a `merged` tombstone (see `deletionStatus`), the `identifier` of the surviving record this one was folded into. Repoint cached references from `identifier` to `mergedInto`.

        '
    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`).
    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
    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
    propLongitude:
      title: propLongitude
      type: number
      format: float
      minimum: -180
      maximum: 180
      example: -73.9934
      description: The longitude of a location
      x-stoplight:
        id: udrk05v1mvsv9
    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'
    enumRadiusUnits:
      type: string
      description: The units of measure for a geo search radius
      enum:
      - mi
      - km
      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_8601)]

              \

              Please note that `doorTime` 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.

              '
          location:
            $ref: '#/components/schemas/MusicVenue'
          offers:
            type: array
            items:
              $ref: '#/components/schemas/Offer'
          performer:
            type: array
            items:
              allOf:
              - $ref: '#/components/schemas/MusicGroup'
              - type: object
                properties:
                  x-performanceDate:
                    type: string
                    format: iso-8601
                    description: 'The date of the performance using ISO 8601 date format [[docs](https://en.wikipedia.org/wiki/ISO_8601)]

                      '
                  x-performanceRank:
                    type: number
                    format: int32
                    require: true
                    description: The "rank" for this performance whithin the event
                  x-isHeadliner:
                    type: boolean
                    default: false
                    require: true
                    description: If this performer is a headliner
                  x-dateIsConfirmed:
                    type: boolean
                    default: false
                    description: 'Required for Festivals.

                      If a Festival performance date is confirmed or not.\

                      If not, it will appear on the first day of the Festival.

                      '
          eventAttendanceMode:
            $ref: '#/components/schemas/enumAttendanceMode'
          isAccessibleForFree:
            type: boolean
            default: false
          x-promoImage:
            type: string
            format: uri
            description: A secondary promotional image for the event (e.g. admat)
    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.

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

            '
    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'
    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

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