---
title: "Gets a seat layout by its unique identifier"
method: GET
path: "/ocapi/v1/seat-layouts/{seatLayoutId}"
tags: ["Seating"]
---

# Gets a seat layout by its unique identifier

`GET /ocapi/v1/seat-layouts/{seatLayoutId}`

## 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/seat-layouts/{seatLayoutId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/vista/apis/vista-digital-platform/docs/ocapi/v1/seat-layouts/:seatLayoutId/get.ts> (a function with typed inputs; its response is checked against the schema)

#### Licenses Required


- Vista.Ocapi

## Path parameters

- `seatLayoutId` string, required

## Headers

- `Connect-Region-Code` string

## Response `200`

Success

- OcapiV1SeatingMasterDataSeatLayoutDetails: Represents the details of a seat layout entity, and its related data
  - `seatLayout` OcapiV1SeatingMasterDataSeatLayout, required: Represents a floor plan associated with a screen
    - `id` string, required: Gets the unique identifier
    - `screenId` string, required: Gets the unique identifier of the screen
    - `boundary` OcapiV1SeatingMasterDataSeatLayoutBoundary, required: Represents a set of three grid coordinates that describe the boundary of a seat layout
      - `right` number, double, required: Gets the rightmost coordinate, in grid units
      - `left` number, double, required: Gets the leftmost coordinate, in grid units
      - `top` number, double, required: Gets the topmost coordinate, in grid units
    - `screenBoundary` OcapiV1SeatingMasterDataScreenBoundary, required: Represents a pair of grid coordinates that describe the width of the screen within the seat layout
      - `left` number, double, required: Gets the leftmost coordinate, in grid units
      - `right` number, double, required: Gets the rightmost coordinate, in grid units
    - `areas` OcapiV1SeatingMasterDataArea[], required: Gets the list area entities
      - `number` integer, required: Gets the number that can be used to uniquely identify the area within the seat layout
      - `areaCategoryId` string, required: Gets the unique identifier of the area category the area belongs to
      - `name` OcapiV1Translatable, required: Represents some customer-visible translatable Text in the default language, and a list of translation entities
        - `text` string, required: Gets the text in the default language
        - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages
          - `languageTag` string, required: Gets the IETF (RFC 4646) language tag that the translation Text has been translated for
          - `text` string, required: Gets the translated text
      - `boundary` OcapiV1SeatingMasterDataAreaBoundary, required: Represents a set of four grid coordinates that describe the position and dimensions of an area within the seat layout
        - `left` number, double, required: Gets the leftmost coordinate, in grid units
        - `top` number, double, required: Gets the topmost coordinate, in grid units
        - `right` number, double, required: Gets the rightmost coordinate, in grid units
        - `bottom` number, double, required: Gets the bottommost coordinate, in grid units
      - `columnCount` integer, required: Gets the number of columns
      - `rowCount` integer, required: Gets the number of rows
      - `rows` OcapiV1SeatingMasterDataRow[], required: Gets the list of row entities
        - `number` integer, required: Gets the number that can be used to uniquely identify the row within the area
        - `label` string, required: Gets the label/physical name
        - `seats` OcapiV1SeatingMasterDataSeat[], required: Gets the list of seat entities
          - `id` string, required: Gets the identifier that can be used to uniquely identify the seat within the seat layout
          - `position` OcapiV1SeatingMasterDataSeatPosition, required: Represents the position of a seat within the seat layout
            - `areaNumber` integer, required: Gets the number that can be used to uniquely identify the area within the seat layout
            - `columnNumber` integer, required: Gets the number that can be used to uniquely identify the column of the seat entity within the area
            - `rowNumber` integer, required: Gets the number that can be used to uniquely identify the row within the area
          - `seatGroupIds` string[], required: Gets the list of unique identifiers of the seat entities that share the same group
          - `label` string, nullable: Gets the label/physical name of the seat
          - `rowLabel` string, required: Gets the label/physical name of the row
          - `areaCategoryId` string, required: Gets the unique identifier of the area category the seat belongs to
          - `type` 'Normal' | 'Wheelchair' | 'Companion' | 'SofaLeft' | 'SofaMiddle' | 'SofaRight', required: Represents the type of a seat
  - `relatedData` OcapiV1SeatingMasterDataSeatLayoutRelatedData, required: Related data for a seat layout entity
    - `screen` OcapiV1BrowsingMasterDataScreensScreen, required: Represents a room belonging to a site where film entities are screened
      - `id` string, required: Gets the unique identifier
      - `name` OcapiV1Translatable, required: Represents some customer-visible translatable Text in the default language, and a list of translation entities
        - `text` string, required: Gets the text in the default language
        - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages
          - `languageTag` string, required: Gets the IETF (RFC 4646) language tag that the translation Text has been translated for
          - `text` string, required: Gets the translated text
    - `areaCategories` OcapiV1SeatingMasterDataAreaCategory[], required: Gets the list of related area category entities
      - `id` string, required: Gets the unique identifier
      - `name` OcapiV1Translatable, required: Represents some customer-visible translatable Text in the default language, and a list of translation entities
        - `text` string, required: Gets the text in the default language
        - `translations` OcapiV1Translation[], required: Gets the translations of the translatable Text in other languages
          - `languageTag` string, required: Gets the IETF (RFC 4646) language tag that the translation Text has been translated for
          - `text` string, required: Gets the translated text
      - `hopk` string, nullable: Gets the Head Office primary key
      - `isAllocatedSeating` boolean, required: Gets a value indicating whether the seat entities are allocated
      - `isInSeatItemDeliveryAvailable` boolean, required: Gets a value indicating whether in-seat item delivery is available for seats belonging to this area category

## Other responses

- `404`: Seat layout 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)