Skip to content

Vista Digital Platform (V1)

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server
https://developer.vista.co/_mock/openapi/digital-platform/openapi

Completed Order Assets

Operations

Completed Orders

Operations

Orders

Operations

Seats

Operations

Discounts

Operations

Events

Operations

Showtimes

Operations

Films

Operations

Gift Cards

Operations

Items

Operations

Journeys

Operations

Third Party Passes

Operations

Loyalty

Operations

Authentication

Operations

Members

Operations

Member Completed Orders

Operations

Friends

Operations

Password Reset

Operations

Payments

Operations

Member Rewards

Operations

Subscriptions

Operations

Ticket Redemption Cards

Operations

Credentials

Operations

Watched Films

Operations

Watchlist Films

Operations

Completion

Operations

Gift shop

Operations

Vouchers

Operations

Refunds

Operations

Seating

Operations

Browsing

Operations

Gets the current list of showtime availability entities

Request

Licenses Required

  • Vista.Ocapi
Query
siteIdsArray of stringsunique

Site filter

filmIdsArray of strings

Film filter

Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  'https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/showtimes/availability?siteIds=string&filmIds=string' \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
showtimeAvailabilitiesArray of objects(ShowtimeAvailability)required
showtimeAvailabilities[].​showtimeIdstringnon-emptyread-onlyrequired
showtimeAvailabilities[].​isSoldOutbooleanrequired
showtimeAvailabilities[].​seatSummaryAreaCategorySeatAvailabilitySummary (object) or SeatAvailabilitySummary (object)required

Represents a seat availability summary for a list of seat entities

One of:

Represents a seat availability summary for an area category

showtimeAvailabilities[].​seatSummary.​areaCategoryIdstringnon-emptyrequired
showtimeAvailabilities[].​seatSummary.​totalCountinteger(int32)required
showtimeAvailabilities[].​seatSummary.​availableCountinteger(int32)required
showtimeAvailabilities[].​areaCategorySeatSummariesArray of objects(AreaCategorySeatAvailabilitySummary)required
showtimeAvailabilities[].​areaCategorySeatSummaries[].​areaCategoryIdstringnon-emptyrequired
showtimeAvailabilities[].​areaCategorySeatSummaries[].​totalCountinteger(int32)required
showtimeAvailabilities[].​areaCategorySeatSummaries[].​availableCountinteger(int32)required
Response
application/json
{
  "showtimeAvailabilities": [
    { … }
  ]
}

Gets the current showtime availability of a particular showtime

Request

Licenses Required

  • Vista.Ocapi
Path
showtimeIdstringrequired

The unique identifier of the showtime

Headers
Connect-Region-Codestring

Region Code

curl -i -X GET \
  'https://developer.vista.co/_mock/openapi/digital-platform/openapi/ocapi/v1/showtimes/{showtimeId}/availability' \
  -H 'Connect-Region-Code: string'

Responses

Success

Bodyapplication/json
showtimeAvailabilityobject(ShowtimeAvailability)required

Represents the current availability of a showtime

showtimeAvailability.​showtimeIdstringnon-emptyread-onlyrequired
showtimeAvailability.​isSoldOutbooleanrequired
showtimeAvailability.​seatSummaryAreaCategorySeatAvailabilitySummary (object) or SeatAvailabilitySummary (object)required

Represents a seat availability summary for a list of seat entities

One of:

Represents a seat availability summary for an area category

showtimeAvailability.​seatSummary.​areaCategoryIdstringnon-emptyrequired
showtimeAvailability.​seatSummary.​totalCountinteger(int32)required
showtimeAvailability.​seatSummary.​availableCountinteger(int32)required
showtimeAvailability.​areaCategorySeatSummariesArray of objects(AreaCategorySeatAvailabilitySummary)required
showtimeAvailability.​areaCategorySeatSummaries[].​areaCategoryIdstringnon-emptyrequired
showtimeAvailability.​areaCategorySeatSummaries[].​totalCountinteger(int32)required
showtimeAvailability.​areaCategorySeatSummaries[].​availableCountinteger(int32)required
Response
application/json
{
  "showtimeAvailability": {
    "showtimeId": "string",
    "isSoldOut": true,
    "seatSummary": { … },
    "areaCategorySeatSummaries": [ … ]
  }
}

Sites

Operations

Surveys

Operations

Third-Party Member Schemes

Operations

Ticket Prices

Operations

Tracking Events

Operations

Tips

Operations