---
title: "List Events for a Venue"
method: GET
path: "/api/event/venue/{id}"
tags: ["Event"]
---

# List Events for a Venue

`GET /api/event/venue/{id}`

## Request

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

List events taking place at a venue, with basic venue information and per-event artist lineups. Note: `venueInfo` is returned as an array of venue records, not a single object.

## Path parameters

- `id` string, required: Chartmetric venue ID.

## Query parameters

- `limit` integer: Maximum number of events to return. Defaults to 20, max 100.
- `offset` integer: Number of items to skip from the start of the result set; pair with `limit` to paginate.

## Response `200`

Success

- object
  - `obj` object
    - `venueInfo` object[], required: Venue records (returned as an array even for a single venue).
      - `doc_id` union: Chartmetric venue ID.
        - integer
        - string
      - `name` string, nullable: Venue name.
      - `lat` number, float, nullable: Venue latitude in decimal degrees (WGS84).
      - `lng` number, float, nullable: Venue longitude in decimal degrees (WGS84).
      - `cm_location` integer, nullable: Chartmetric location ID linking the venue to a city/region.
      - `code2` string, nullable: Country of the venue (ISO 3166-1 alpha-2 code).
      - `image_url` string, nullable: Venue image URL.
      - `city_id` integer, nullable: Chartmetric city ID where the venue is located.
      - `capacity` integer, nullable: Approximate audience capacity of the venue.
      - `city_name` string, nullable: City name where the venue is located.
      - `venue_url` string, nullable: Venue's official website URL.
    - `events` object[], required: Events at the venue, ordered by `start_date` (newest first) and paginated by `limit`/`offset`.
      - `event_id` integer, required: Chartmetric event ID.
      - `event_name` string, nullable: Event name.
      - `event_image_url` string, nullable: Event image URL.
      - `start_date` string, date-time, nullable: Event start date in ISO 8601 format.
      - `end_date` union: Currently always an empty string due to a latent reducer bug.
        - string
        - string, date-time
      - `artists` object[], required: Artists performing at the event.
        - `id` integer, nullable: Chartmetric artist ID.
        - `name` string, nullable: Artist name.
        - `is_headliner` boolean, nullable: True if the artist headlined the event, false if they performed but did not headline, null if headliner status is unknown.

---

[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)