---
title: "GET /api/feed/v1/events/{eventId}/seat-map"
method: GET
path: "/api/feed/v1/events/{eventId}/seat-map"
tags: ["Feed"]
---

# GET /api/feed/v1/events/{eventId}/seat-map

`GET /api/feed/v1/events/{eventId}/seat-map`

## Request

- Base URL: `https://api.findticker.com`
- URL: `https://api.findticker.com/api/feed/v1/events/{eventId}/seat-map`
- Auth: HTTP bearer

## Path parameters

- `eventId` string, required

## Query parameters

- `version` string

## Response `200`

The event's whole primary seat map in one answer: every section in seat map order, every row in it, and every seat name in the row, at the current seat map version unless version names another. seats is the truth; first_seat and last_seat are a shorthand set only where the names are whole numbers that step by one. place_start joins a seat to GET /v1/events/{eventId}/seat-history (place_index) under the same seat_map_version. General admission sections are listed with ga true, the count the map states and no rows. A seat map covers one event; for a venue, list its events with GET /v1/venues/{venueId}/schedule and read each one. A large house is several hundred kilobytes, so the answer is compressed when the request accepts gzip. meta.covered false means the event has no primary seat map. Costs ONE UNIT whatever the seat count.

- FeedEventSeatMap
  - `event_id` string, nullable, required
  - `seat_map_version` string, nullable, required: The seat map version these names belong to. A version never changes what it names; a new version can renumber places. Null when the event has no primary seat map.
  - `sections` FeedSeatMapSection[], required: Every section in seat map order, general admission sections included.
    - `section` string, required: The section code printed on a ticket.
    - `ga` boolean, required: True for a general admission section, which has a quantity and no seats, so rows is empty.
    - `place_start` integer, nullable, required: The place index of the section's first seat. Null on a general admission section.
    - `seat_count` integer, required: Seats in the section. On a general admission section, the count the seat map states for it, which is a capacity and not a number put on sale.
    - `rows` FeedSeatMapRow[], required
      - `row` string, nullable, required: The row name. Null for places the seat map puts in no row.
      - `place_start` integer, required: The place index of the row's first seat; seats[i] is place place_start + i. The same index GET /v1/events/{eventId}/seat-history takes as place_index, under the same seat_map_version.
      - `seat_count` integer, required
      - `first_seat` string, nullable, required: The first seat name, set only when every name in the row is a whole number and each steps by one from the one before. Null otherwise, for example an odd or even numbered row; seats is the full list either way.
      - `last_seat` string, nullable, required: The last seat name, under the same rule as first_seat.
      - `seats` string[], required: Every seat name in the row, in seat map order.
  - `meta` object, required
    - `sections` integer, required
    - `ga_sections` integer, required
    - `rows` integer, required
    - `seats` integer, required: Reserved seats named in this document, which is the sum of every row's seat_count.
    - `covered` boolean, required: False when the event has no primary seat map. The event exists and the call still costs one unit; sections is then empty.
    - `units_charged` integer, required

## Other responses

- `400`: Validation error, an unknown `columns` name (the message lists the valid set), or a batch over the size bound.
- `401`: Missing or invalid API key.
- `403`: The key's account is not entitled to the feed, or the account or the address it calls from is blocked (`reason` `blocked`).
- `404`: No such event, or version names a seat map version the event does not have.
- `429`: The per-minute burst ceiling or the unit budget for the current UTC date is used up.
- `500`: Internal Server Error.

---

[API](https://skmtc.dev/findticker/apis/ticker-api.md) · [All operations](https://skmtc.dev/findticker/apis/ticker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findticker/apis/ticker-api/revisions/b6229ca924f4?raw)