---
title: "Gets the current list of discount availability entities for a particular showtime"
method: GET
path: "/ocapi/v1/showtimes/{showtimeId}/discount-availability"
tags: ["Discounts"]
---

# Gets the current list of discount availability entities for a particular showtime

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

This endpoint returns availabilities for discount entities with respect to the time of the showtime
#### Licenses Required


- Vista.Ocapi

## Path parameters

- `showtimeId` string, required

## Headers

- `Connect-Region-Code` string

## Response `200`

Success

- union: Represents a list of discount availability entities
  - OcapiV1SalesAvailabilityDiscountAvailabilityListDetails: Represents a list of discount availability entities
    - `discountAvailabilities` OcapiV1SalesAvailabilityDiscountAvailability[], required: Gets the list of discount availability entities
      - `discountId` string, required: Gets the unique identifier of the discount
      - `isAvailable` boolean, required: Gets a value indicating whether the discount is available
      - `unavailableReason` 'NotApplicable' | 'UnavailableForFilm' | 'UnavailableForDistributor' | 'UnavailableForPublicHoliday' | 'UnavailableForDayOfWeek' | 'UnavailableForTime' | 'UnavailableForDate', required: Represents the reasons that a discount may not be available
  - OcapiV1SalesAvailabilitySiteDiscountAvailabilityListDetails: Represents a list of discount availability entities for a particular site
    - `discountAvailabilities` OcapiV1SalesAvailabilityDiscountAvailability[], required: Gets the list of discount availability entities
      - `discountId` string, required: Gets the unique identifier of the discount
      - `isAvailable` boolean, required: Gets a value indicating whether the discount is available
      - `unavailableReason` 'NotApplicable' | 'UnavailableForFilm' | 'UnavailableForDistributor' | 'UnavailableForPublicHoliday' | 'UnavailableForDayOfWeek' | 'UnavailableForTime' | 'UnavailableForDate', required: Represents the reasons that a discount may not be available
    - `siteId` string, required: Gets the unique identifier of the site
    - `isDefault` boolean, required: Gets a value indicating whether this is the default discount availability list details for the site
    - `siteOrderLocationId` string, nullable: Gets the unique identifier of the site order location, if applicable

## Other responses

- `404`: Showtime does not exist.

## Changes

- **2026-10-09** `41415d239083`: 3 breaking
  - added `#/components/schemas/Ocapi.V1.Sales.Availability.DiscountAvailabilityListDetails, #/components/schemas/Ocapi.V1.Sales.Availability.SiteDiscountAvailabilityListDetails` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `discountAvailabilities` from the response with the `200` status

[Operation history](https://skmtc.dev/vista/apis/vista-digital-platform/changes/ocapi/v1/showtimes/:showtimeId/discount-availability/get.md)

---

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