JamBase Data API

{
  "info": {
    "description": "REST API for concerts, festivals, artists, and venues featuring normalized data from JamBase.",
    "version": "3.1.0",
    "title": "JamBase Concert Data API",
    "contact": {
      "email": "[email protected]",
      "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"
  },
  "openapi": "3.1.0",
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "API key as Bearer token. Get your key from your account dashboard."
      }
    },
    "parameters": {
      "pageParam": {
        "in": "query",
        "name": "page",
        "description": "Page number of results to retrieve",
        "required": false,
        "schema": {
          "type": "integer",
          "default": 1
        }
      },
      "perPageParam": {
        "in": "query",
        "name": "perPage",
        "description": "Number of events per page of results",
        "required": false,
        "schema": {
          "type": "integer",
          "default": 40,
          "minimum": 1,
          "maximum": 100
        }
      },
      "eventTypeParam": {
        "in": "query",
        "name": "eventType",
        "description": "Used to isolate only concerts or only festivals(s)\\\nLeave blank to include both concerts and festivals\n- eventType=concert\n- eventType=festival\n",
        "schema": {
          "$ref": "#/components/schemas/enumEventType"
        }
      },
      "eventIdParam": {
        "in": "query",
        "name": "eventId",
        "description": "Restrict the result set to a specific list of Event IDs.\\\n\\\nFor example to fetch a single event:\n- eventId=jambase:16013248\n\nUse a pipe (|) to include multiple event IDs (recommended form, consistent with `artistId` and `venueId`):\n- eventId=jambase:16013248|jambase:14331594\n\nA URL-encoded JSON array of IDs is also accepted for compatibility with the v1 `eventId` parameter:\n- eventId=%5B%22jambase%3A16013248%22%2C%22jambase%3A14331594%22%5D\n\nTo use non-JamBase data sources, use the EventDataSource [[enum](#)] for the ID(s) you are using.\n",
        "schema": {
          "type": "string",
          "example": "jambase:16013248|jambase:14331594"
        }
      },
      "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.\n- name=Bonnaroo\n- name=Phish%20New%20Year\n",
        "example": "Bonnaroo",
        "schema": {
          "type": "string"
        }
      },
      "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"
        }
      },
      "artistNameParam": {
        "in": "query",
        "name": "artistName",
        "description": "A keyword-based search for artist name(s).\n- artistName=Billie%20Eilish\n\nUse a pipe (|) to include multiple artist names.\n- artistName=Billie%20Eilish|Lucy%20Dacus\n\nKeywords should be URL Encoded.\\\nFor more precise artist-specific results try using `artistId` or `artist[slug]`.\n\nPlease note that `artistName` cannot be used togehter with `artistId` type searches and will be ignored if `artistId` is provided.\n",
        "example": "Billie Eilish",
        "schema": {
          "type": "string"
        }
      },
      "genreSlugParam": {
        "in": "query",
        "name": "genreSlug",
        "description": "Restrict results to a genre.\n- genreSlug=bluegrass\n\nUse a pipe (|) to include results from multiple genres.\n- genreSlug=bluegrass|blues\n",
        "schema": {
          "$ref": "#/components/schemas/enumGenres"
        }
      },
      "venueIdParam": {
        "in": "query",
        "name": "venueId",
        "description": "The source and unique identifier for the venue(s)\n- venueId=jambase:62108\n\nUse a pipe (|) to include multiple venue IDs\n- venueId=jambase:62108|jambase:7932731\n\nTo 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\n- venueId=ticketmaster:k7vGF99ORYpnS\n",
        "example": "jambase:62108",
        "schema": {
          "type": "string"
        }
      },
      "venueNameParam": {
        "in": "query",
        "name": "venueName",
        "description": "A keyword-based search for venue name(s).\n- venueName=Brooklyn%20Bowl\n\nUse a pipe (|) to include multiple venue IDs.\n- venueName=Brooklyn%20Bowl|House%20of%20Blues\n\nFor more precise venue-specific results try using `venueId` or `venue[slug]`.\n",
        "example": "Brooklyn%20Bowl",
        "schema": {
          "type": "string"
        }
      },
      "geoLatitudeParam": {
        "in": "query",
        "name": "geoLatitude",
        "description": "The latitude for geographic radius.\n- geoLatitude=40.7505\n",
        "schema": {
          "$ref": "#/components/schemas/propLatitude"
        }
      },
      "geoLongitudeParam": {
        "in": "query",
        "name": "geoLongitude",
        "description": "The longitude for geographic radius.\n- geoLongitude=-73.9934\n",
        "schema": {
          "$ref": "#/components/schemas/propLongitude"
        }
      },
      "geoStateIsoParam": {
        "in": "query",
        "name": "geoStateIso",
        "description": "The State code in ISO_3166-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-2)].\n- geoStateIso=US-NY\n\nUse a pipe (|) to include multiple State codes.\n- geoStateIso=US-NY|=US-PA\n\nNote: Available for United States, Canada, and Australia only.\n",
        "schema": {
          "$ref": "#/components/schemas/enumState"
        }
      },
      "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>.\n- geoMetroId=jambase:1\n\nUse a pipe (|) to include multiple metro IDs.\n- geoMetroId=jambase:1|jambase:5\n",
        "example": "jambase:1",
        "schema": {
          "type": "string"
        }
      },
      "geoCityNameParam": {
        "in": "query",
        "name": "geoCityName",
        "description": "Use to retrieve events for city name(s).\n- geoCityName=Seattle\n\nUse a pipe (|) to include multiple city names.\n- geoCityName=Seattle|Tacoma\n\nFor more precise city-specific results try using `city[id]`\n",
        "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"
        }
      },
      "geoIpParam": {
        "in": "query",
        "name": "geoIp",
        "description": "Use to retrieve events near an IP address.\\\nSupports IPv4 or IPv6 values.\n- geoIp=55.123.456.789\n",
        "schema": {
          "oneOf": [
            {
              "type": "string",
              "format": "ipv4"
            },
            {
              "type": "string",
              "format": "ipv6"
            }
          ]
        }
      },
      "geoRadiusAmountParam": {
        "in": "query",
        "name": "geoRadiusAmount",
        "description": "The search radius for lat/lng type searches.\n- geoRadiusAmount=60\n",
        "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.\n- geoRadiusUnits=km\n",
        "schema": {
          "$ref": "#/components/schemas/enumRadiusUnits"
        }
      },
      "geoCountryIso2Param": {
        "in": "query",
        "name": "geoCountryIso2",
        "description": "The two-letter ISO code for a country.\n- geoCountryIso2=US\n\nUse a pipe (|) to include multiple countries.\n- geoCountryIso2=US|CA\n",
        "schema": {
          "$ref": "#/components/schemas/enumCountryIso2"
        }
      },
      "geoCountryIso3Param": {
        "in": "query",
        "name": "geoCountryIso3",
        "description": "The three-letter ISO code for a country.\n- geoCountryIso3=USA\n\nUse a pipe (|) to include multiple countries.\n- geoCountryIso3=USA|CAN\n",
        "schema": {
          "$ref": "#/components/schemas/enumCountryIso3"
        }
      },
      "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"
        }
      },
      "dateFromParam": {
        "in": "query",
        "name": "eventDateFrom",
        "description": "For `concerts` must start on or after this date.\\\nFor `festivals`, must start on or after this date.\\\nIf left blank or omitted, will use the current date.\\\nThe `expandPastEvents` parameter is required when using `eventDateFrom` before the current date.\n\n- eventDateFrom=2023-10-31\n\nNote: Dates use <a href=\"https://www.rfc-editor.org/rfc/rfc3339#section-5.6\">RFC3339</a> format.\n",
        "example": "2023-10-01",
        "schema": {
          "type": "string",
          "format": "date"
        }
      },
      "dateToParam": {
        "in": "query",
        "name": "eventDateTo",
        "description": "For `concerts` must start on or before this date.\\\nFor `festivals` must end on or before this date.\\\nIf left blank or omitted, will return all events after `eventDateFrom`.\n\n- eventDateTo=2023-12-31\n\nNote: Dates use <a href=\"https://www.rfc-editor.org/rfc/rfc3339#section-5.6\">RFC3339</a> format.\n",
        "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.\\\nIf left blank or omitted, will use all updated on dates\n\n- dateModifiedFrom=2022-10-31 00:00:00\n\nNote: Use <a href=\"https://www.rfc-editor.org/rfc/rfc3339#section-5.6\">RFC3339</a> format for parameter values.\n",
        "example": "2022-10-31 00:00:00",
        "schema": {
          "type": "string",
          "format": "rfc3339"
        }
      },
      "datePublishedFromParam": {
        "in": "query",
        "name": "datePublishedFrom",
        "description": "Must have been first published on or after this dateTime in GMT.\\\n\\\nIf left blank or omitted, will use all first published on dates.\n\n- datePublishedFrom=2022-01-01 00:00:00\n\nNote: Use <a href=\"https://www.rfc-editor.org/rfc/rfc3339#section-5.6\">RFC3339</a> format for parameter values.\n",
        "example": "2022-01-01 00:00:00",
        "schema": {
          "type": "string",
          "format": "rfc3339"
        }
      },
      "streamDataSourceParam": {
        "in": "query",
        "name": "streamDataSource",
        "description": "Filter streams to those sourced from a specific stream platform.\n\nv3 currently exposes a single source slug — `jambase` — which represents JamBase's normalized stream catalog. Pipe-delimited values are supported for forward compatibility:\n\n- streamDataSource=jambase\n",
        "schema": {
          "$ref": "#/components/schemas/enumStreamDataSource"
        }
      },
      "excludeEventPerformersParam": {
        "in": "query",
        "name": "excludeEventPerformers",
        "description": "Use `true` to suppress the `performer` node in `Concert` and `Festival` objects.\n",
        "schema": {
          "type": "boolean",
          "default": false
        }
      },
      "expandPastEventsParam": {
        "in": "query",
        "name": "expandPastEvents",
        "description": "Use `true` to include past/historical `Concert` and `Festival` objects.\n\\\nWhen searching events, must be combined with `artistId` or `venueId` parameter.\n\\\nNote: The `expandPastEvents` parameter requires that your apikey has the `expandPastEvents` enhancement turned on. Please contact JamBase to request access to this feature.\n",
        "schema": {
          "type": "boolean",
          "default": false
        }
      },
      "sortEventsParam": {
        "in": "query",
        "name": "sort",
        "description": "Sort order for the returned events.\n\\\n- `eventDate` — ascending by event date (oldest first). This is the default.\n\\\n- `-eventDate` — descending by event date (most recent first).\n\\\nThe leading `-` indicates descending order, following the [JSON:API](https://jsonapi.org/format/#fetching-sorting) convention.\n\\\nMost useful when combined with `expandPastEvents=true` to retrieve an artist's or venue's most recent shows first without paginating through their full history.\n",
        "schema": {
          "type": "string",
          "enum": ["eventDate", "-eventDate"],
          "default": "eventDate"
        }
      },
      "expandExternalIdentifiersParam": {
        "in": "query",
        "name": "expandExternalIdentifiers",
        "description": "Use `true` to include external IDs for `Concert`, `Artist`, and `Venue` objects.\n\\\nNote: The `expandExternalIdentifiers` parameter requires that your apikey has the `expandExternalIdentifiers` enhancement turned on. Please contact JamBase to request access to this feature.\n",
        "schema": {
          "type": "boolean",
          "default": false
        }
      },
      "expandArtistSameAsParam": {
        "in": "query",
        "name": "expandArtistSameAs",
        "description": "Use `true` to include `sameAs` (i.e. links) for `Artist` responses.\n",
        "schema": {
          "type": "boolean",
          "default": false
        }
      }
    },
    "schemas": {
      "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"]
      },
      "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"]
      },
      "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"]
      },
      "enumStreamDataSource": {
        "type": "string",
        "description": "Data source slugs to use for Stream IDs",
        "enum": ["jambase"],
        "x-tags": ["Enums"]
      },
      "enumEventType": {
        "type": "string",
        "description": "The type of event being requested",
        "enum": ["concerts", "festivals"],
        "x-tags": ["Enums"]
      },
      "enumEventStatus": {
        "type": "string",
        "description": "The scheduling status for the event",
        "enum": ["scheduled", "postponed", "rescheduled", "cancelled"],
        "x-tags": ["Enums"]
      },
      "enumRadiusUnits": {
        "type": "string",
        "description": "The units of measure for a geo search radius",
        "enum": ["mi", "km"],
        "x-tags": ["Enums"]
      },
      "enumDatePresets": {
        "type": "string",
        "description": "Presets for frequently used date ranges.\n",
        "enum": [
          "today",
          "tomorrow",
          "thisWeekend",
          "nextWeekend",
          "halloween",
          "newYears",
          "july4th"
        ],
        "x-tags": ["Enums"]
      },
      "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"]
      },
      "enumAttendanceMode": {
        "type": "string",
        "default": "offline",
        "description": "Indicates whether it occurs online, offline, or a mix.",
        "enum": ["mixed", "offline", "online"],
        "x-tags": ["Enums"]
      },
      "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"]
      },
      "enumState": {
        "type": "string",
        "format": "iso-3166-2",
        "description": "A State code in ISO 3166-2 format [[docs](https://en.wikipedia.org/wiki/ISO_3166-2)].\n",
        "example": "US-AZ",
        "enum": [
          "US-AL",
          "US-AK",
          "US-AZ",
          "US-AR",
          "US-CA",
          "US-CO",
          "US-CT",
          "US-DE",
          "US-FL",
          "US-GA",
          "US-HI",
          "US-ID",
          "US-IL",
          "US-IN",
          "US-IA",
          "US-KS",
          "US-KY",
          "US-LA",
          "US-ME",
          "US-MD",
          "US-MA",
          "US-MI",
          "US-MN",
          "US-MS",
          "US-MO",
          "US-MT",
          "US-NE",
          "US-NV",
          "US-NH",
          "US-NJ",
          "US-NM",
          "US-NY",
          "US-NC",
          "US-ND",
          "US-OH",
          "US-OK",
          "US-OR",
          "US-PA",
          "US-RI",
          "US-SC",
          "US-SD",
          "US-TN",
          "US-TX",
          "US-UT",
          "US-VT",
          "US-VA",
          "US-WA",
          "US-WV",
          "US-WI",
          "US-WY",
          "US-DC",
          "US-AS",
          "US-GU",
          "US-MP",
          "US-PR",
          "US-UM",
          "US-VI",
          "AU-ACT",
          "AU-NSW",
          "AU-NT",
          "AU-QLD",
          "AU-SA",
          "AU-TAS",
          "AU-VIC",
          "AU-WA",
          "CA-AB",
          "CA-BC",
          "CA-MB",
          "CA-NB",
          "CA-NL",
          "CA-NS",
          "CA-NT",
          "CA-NU",
          "CA-ON",
          "CA-PE",
          "CA-QC",
          "CA-SK",
          "CA-YT"
        ],
        "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)].\n",
        "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"]
      },
      "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)].\n",
        "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"]
      },
      "AdministrativeArea": {
        "title": "AdministrativeArea",
        "description": "A Metro Area comprised of multiple cities.",
        "type": "object",
        "properties": {
          "@type": {
            "type": "string",
            "enum": ["AdministrativeArea"]
          },
          "identifier": {
            "type": "string",
            "example": "jambase:13412",
            "description": "The unique JamBase identifier for the Metro Area."
          },
          "name": {
            "type": "string",
            "example": "New York Area",
            "description": "The name of the Metro Area"
          },
          "geo": {
            "$ref": "#/components/schemas/GeoCoordinates",
            "description": "The lat/lng for the centroid of the Metro Area"
          },
          "address": {
            "type": "object",
            "properties": {
              "addressRegion": {
                "$ref": "#/components/schemas/enumState",
                "description": "The primary State/Region for Metro Area."
              },
              "addressCountry": {
                "$ref": "#/components/schemas/enumCountryIso2"
              }
            }
          },
          "containsPlace": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/City"
            }
          },
          "x-primaryCityId": {
            "type": "number",
            "format": "int32",
            "example": 12,
            "description": "The unique identifier for the primary City for Metro Area."
          },
          "x-numUpcomingEvents": {
            "type": "number",
            "format": "int32",
            "example": 12,
            "description": "The number of upcoming events across all Cities in this Metro."
          }
        },
        "x-stoplight": {
          "id": "xyb6dq20xkoa2"
        }
      },
      "City":

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