---
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}`

#### 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.net/vista/apis/vista-digital-platform.md) · [All operations](https://skmtc.net/vista/apis/vista-digital-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vista/vista-digital-platform/revisions/3a81c0aed14e/schema)