Festival List

​

Get Chartmetric's Festival List. Supports filtering by country codes, genre IDs, event-size categories, and name search. Sort by festivalName, rank, startDate (default), numberOfDays, eventSize, score, or totalEditions.

Query Parameters
  • code2s[]
    Type: array string[] · code2[]

    Filter to festivals held in these countries (ISO 3166-1 alpha-2 codes, e.g. ['US', 'GB']).

  • genreIds[]
    Type: array integer[]

    Filter to festivals matching any of these Chartmetric genre IDs.

  • sortColumn
    Type: string enum

    Column used to sort the festival list. One of rank, score, festivalName, startDate, numberOfDays, eventSize, totalEditions. Defaults to startDate.

    values
    • rank
    • score
    • festivalName
    • startDate
    • numberOfDays
    • eventSize
    • totalEditions
  • sortOrderDesc
    Type: boolean

    If true, sort sortColumn in descending order. Defaults to false.

  • nameSearch
    Type: string
    max length:  
    100

    Case-insensitive substring filter on festival name.

  • limit
    Type: integer
    min:  
    1

    Maximum number of items to return per request.

  • offset
    Type: integer
    min:  
    0
    max:  
    100000

    Number of items to skip from the start of the result set; bounded by the public API offset limit.

  • eventSizes[]
    Type: array string[] enum

    Filter by festival size category. One of small, medium, large, mega.

    values
    • small
    • medium
    • large
    • mega
Responses
  • application/json
Request Example for get/api/festival/list
curl https://api.chartmetric.com/api/festival/list \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "id": 642168,
      "name": "Rock Werchter",
      "date": "2025-07-03 00:00:00.000",
      "numberOfDays": 3,
      "city": "Werchter",
      "country": "BE",
      "performersCount": 89,
      "popularityRank": 21,
      "eventSize": "Mega (60K+)",
      "topGenres": [
        {
          "id": 501120,
          "name": "pop"
        },
        {
          "id": 501122,
          "name": "rock"
        },
        {
          "id": 501124,
          "name": "electronic"
        }
      ],
      "links": {
        "jambase": "https://www.jambase.com/festival/rock-werchter-2025",
        "songkick": null,
        "seatgeek": null
      }
    }
  ]
}

Success