---
title: "Gets the seat availability for a showtime"
method: GET
path: "/ocapi/v1/showtimes/{showtimeId}/seat-availability"
tags: ["Seating"]
---

# Gets the seat availability for a showtime

`GET /ocapi/v1/showtimes/{showtimeId}/seat-availability`

## Request

- Base URL: `https://developer.vista.co` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.vista.co/ocapi/v1/showtimes/{showtimeId}/seat-availability`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vista/apis/vista-digital-platform/docs/ocapi/v1/showtimes/:showtimeId/seat-availability/get.ts> (a function with typed inputs; its response is checked against the schema)

The response is output cached for a maximum duration depending on preview.




If the underlying showtime is unallocated, showtime seat availability SeatAvailabilities
will be set to an empty seat availability[]




#### Bad request response
Seat availability for showtime response returns *400* status when seat allocation for the showtime is disabled.
When there are seats for a showtime that are sold out or the showtime is marked as sold out at Cinema,
seat availability for showtime returns a *200* response with `sold` status for all seats.

#### Licenses Required


- Vista.Ocapi

## Path parameters

- `showtimeId` string, required

## Query parameters

- `preview` boolean

## Headers

- `Connect-Region-Code` string

## Response `200`

Success

- OcapiV1SeatingAvailabilityShowtimeSeatAvailability: Represents a list of seat availability entities for a particular showtime
  - `seatAvailabilities` OcapiV1SeatingAvailabilitySeatAvailability[], required
    - `seatId` string, required: Gets the unique identifier of the seat
    - `status` 'Available' | 'Sold' | 'Broken' | 'House', required: Represents the availability status of a seat
  - `isSoldOut` boolean, required
  - `summary` union, required: Represents a seat availability summary for a list of seat entities
    - OcapiV1SeatingAvailabilityAreaCategorySeatAvailabilitySummary: Represents a seat availability summary for an area category
      - `areaCategoryId` string, required
      - `totalCount` integer, required
      - `availableCount` integer, required
    - OcapiV1SeatingAvailabilitySeatAvailabilitySummary
      - `totalCount` integer, required
      - `availableCount` integer, required
  - `areaCategorySummaries` OcapiV1SeatingAvailabilityAreaCategorySeatAvailabilitySummary[], required
    - `areaCategoryId` string, required
    - `totalCount` integer, required
    - `availableCount` integer, required

## Other responses

- `404`: Showtime does not exist.

---

[API](https://skmtc.dev/vista/apis/vista-digital-platform.md) - [All operations](https://skmtc.dev/vista/apis/vista-digital-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/vista/apis/vista-digital-platform/revisions/c46f30854000?raw)