---
title: "Festival List"
method: GET
path: "/api/festival/list"
tags: ["Festival"]
---

# Festival List

`GET /api/festival/list`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/festival/list`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/festival/list/get.ts> (a function with typed inputs; its response is checked against the schema)

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[]` string[]: Filter to festivals held in these countries (ISO 3166-1 alpha-2 codes, e.g. ['US', 'GB']).
- `genreIds[]` integer[]: Filter to festivals matching any of these Chartmetric genre IDs.
- `sortColumn` 'rank' | 'score' | 'festivalName' | 'startDate' | 'numberOfDays' | 'eventSize' | 'totalEditions': Column used to sort the festival list. One of `rank`, `score`, `festivalName`, `startDate`, `numberOfDays`, `eventSize`, `totalEditions`. Defaults to `startDate`.
- `sortOrderDesc` boolean: If true, sort `sortColumn` in descending order. Defaults to false.
- `nameSearch` string: Case-insensitive substring filter on festival name.
- `limit` integer: Maximum number of items to return per request.
- `offset` integer: Number of items to skip from the start of the result set; bounded by the public API offset limit.
- `eventSizes[]` string[]: Filter by festival size category. One of `small`, `medium`, `large`, `mega`.

## Response `200`

Success

- object
  - `obj` object[], required
    - `id` integer, nullable, required: Chartmetric event ID for the festival.
    - `name` string, nullable, required: Festival name.
    - `date` string, nullable, required: Festival start date in `YYYY-MM-DD HH:MM:SS.MMM` format.
    - `numberOfDays` integer, nullable, required: Number of days the festival lasts.
    - `city` string, nullable, required: City where the festival is held.
    - `country` string, nullable, required: Country where the festival is held (ISO 3166-1 alpha-2 code).
    - `performersCount` integer, nullable, required: Number of artists associated with the festival lineup.
    - `popularityRank` integer, nullable, required: Festival popularity rank (lower is more popular).
    - `eventSize` string, required: Size category of the festival (e.g. `Mega (60K+)`, `Large`, `Medium`, `Small`).
    - `topGenres` object[], required: Top genres associated with the festival.
      - `id` integer, required: Chartmetric genre ID.
      - `name` string, required: Genre name.
    - `links` object, required: Links to external pages about the festival.
      - `jambase` string, nullable: JamBase festival page URL, when available.
      - `songkick` string, nullable: Songkick festival page URL, when available.
      - `seatgeek` string, nullable: SeatGeek festival page URL, when available.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)