---
title: "Get Festival Series Archive"
method: GET
path: "/festivals/{festivalSeriesId}/events"
tags: ["FestivalSeries"]
---

# Get Festival Series Archive

`GET /festivals/{festivalSeriesId}/events`

## Request

- Base URL: `https://api.data.jambase.com/v3`
- URL: `https://api.data.jambase.com/v3/festivals/{festivalSeriesId}/events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/jambase/apis/jambase-concert-data-api/docs/festivals/:festivalSeriesId/events/get.ts> (a function with typed inputs; its response is checked against the schema)

The full archive: every edition as a core-spec `Festival` event with a flat `performer` array carrying `x-performanceDate` / `x-performanceRank` / `x-isHeadliner` per artist (billing rank resets per day), plus per-artist JamBase id, genres and image URL. `expandExternalIdentifiers=true` adds MusicBrainz + Spotify ids per performer. Series context rides once at the top level as `x-festivalSeries`. Requires festival archive history access on your plan (implied by `allow_past_events`).

## Path parameters

- `festivalSeriesId` string, required

## Query parameters

- `expandExternalIdentifiers` boolean
- `perPage` integer
- `page` integer

## Response `200`

Full edition-by-edition archive as events

- object
  - `success` boolean
  - `pagination` Pagination: Enclosure for pagination values.
    - `page` integer: The current page of results.
    - `perPage` integer: Number of events per page of results.
    - `totalItems` integer: Total results for the request.
    - `totalPages` integer: Total pages for the request.
    - `nextPage` string, url: The absolute URL for the next page of results, if available (e.g. `https://api.data.jambase.com/v3/events?page=2`).
    - `previousPage` string, url: The absolute URL for the previous page of results, if available (e.g. `https://api.data.jambase.com/v3/events?page=1`).
  - `x-festivalSeries` object
    - `@type` string
    - `identifier` string
    - `name` string
    - `url` string, url
    - `image` string, url: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images. A general image or logo for the festival, not a lineup poster.
  - `events` object[]
    - `@type` string
    - `identifier` string
    - `name` string
    - `startDate` string, date
    - `endDate` string, date
    - `eventStatus` string
    - `location` object
      - `@type` string
      - `name` string
      - `address` object
        - `@type` string
        - `addressLocality` string
        - `addressRegion` string
        - `addressCountry` string
    - `x-isUpcoming` boolean
    - `x-performerCount` integer
    - `performer` object[]
      - `@type` string
      - `name` string
      - `identifier` string
      - `image` string, url: URL of an illustrative image, such as a press photo or logo. Most images are owned by third parties and JamBase grants no rights in them. Display by URL or from your own cache, refreshed when the URL changes. See https://data.jambase.com/api/docs/images.
      - `genre` string[]
      - `x-performanceDate` string, date: Performance day; billing rank resets per day.
      - `x-performanceRank` integer: Billing rank within the performance day (1 = top of the bill).
      - `x-isHeadliner` boolean
      - `x-externalIdentifiers` object[]: Present when `expandExternalIdentifiers=true`.
        - `source` string
        - `identifier` string[]
  - `request` Request: Enclosure for request details.
    - `endpoint` string, url: The base endpoint requested
    - `method` string: The request method (e.g. GET, POST)
    - `params` unknown[]: The parameters for the request
      - unknown
    - `ip` union: The requesting IP address, IPv4 or IPv6
      - string, ipv4
      - string, ipv6
    - `userAgent` string, string: The requesting UserAgent

## Other responses

- `403`: Caller lacks festival archive history access

---

[API](https://skmtc.dev/jambase/apis/jambase-concert-data-api.md) - [All operations](https://skmtc.dev/jambase/apis/jambase-concert-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jambase/apis/jambase-concert-data-api/revisions/487fb580fa61?raw)