---
title: "Adds a ticket redemption card to an in progress standard order"
method: POST
path: "/ocapi/v1/orders/{orderId}/ticket-redemption-cards"
tags: ["Ticket Redemption Cards"]
---

# Adds a ticket redemption card to an in progress standard order

`POST /ocapi/v1/orders/{orderId}/ticket-redemption-cards`

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

This endpoint validates the provided third party member card credentials or member ticket redemption card base
and stores a successfully validated card against the order for later use.




For third party member card entities belonging to a third party member scheme that supports partial approvals,
an arbitrarily large number of tickets will be requested to determine how many redemptions are actually available.




For third party member card entities belonging to a third party member scheme that does not support partial approvals,
the number of tickets requested will depend on a preconfigured quantity per showtime, or only one ticket if no quantity has been configured.



This endpoint cannot be used for orders that have a parent order (see standard order ParentOrderId)
#### Licenses Required


- Vista.Ocapi

## Path parameters

- `orderId` string, required

## Headers

- `loyaltySessionToken` string
- `Connect-Region-Code` string

## Request body

- union: Represents the information required to add an order ticket redemption card base to an in progress standard order
  - OcapiV1OrdersTicketRedemptionCardsRequestsOrderMemberTicketRedemptionCardRequest: Represents the information required to add an order ticket redemption card base to an in progress standard order
    - `showtimeId` string, required: Gets the unique identifier of the showtime that the ticket redemption card will be validated for
    - `type` 'ThirdPartyMemberCard' | 'MemberTicketRedemptionCard', required: Represents the type of an order third party member card request
  - OcapiV1OrdersTicketRedemptionCardsRequestsOrderThirdPartyMemberCardRequest: Represents the information required to add an order ticket redemption card base to an in progress standard order
    - `showtimeId` string, required: Gets the unique identifier of the showtime that the ticket redemption card will be validated for
    - `type` 'ThirdPartyMemberCard' | 'MemberTicketRedemptionCard', required: Represents the type of an order third party member card request

## Response `200`

Success

- OcapiV1OrdersTicketRedemptionCardsOrderTicketRedemptionCardDetails: Represents the details of an order ticket redemption card base that has been added to an in progress standard order, and its order ticket redemption card ticket type availability entities
  - `ticketRedemptionCard` union, required: Represents the base properties of a ticket redemption card base that has been added to a standard order
    - OcapiV1OrdersTicketRedemptionCardsOrderMemberSubscriptionCard: Represents the base properties of a card that can be redeemed to purchase tickets
      - `type` 'MemberSubscriptionCard' | 'ThirdPartyMemberCard', required: Represents the type of a ticket redemption card base
      - `maskedCardNumber` string, required: Gets a masked representation of the card number
      - `memberName` OcapiV1PersonName: Represents the parts of a person's name
        - `givenName` string, nullable: Gets the given name
        - `familyName` string, nullable: Gets the family name
        - `middleName` string, nullable: Gets the middle or any additional name
    - OcapiV1OrdersTicketRedemptionCardsOrderThirdPartyMemberCard: Represents the base properties of a card that can be redeemed to purchase tickets
      - `type` 'MemberSubscriptionCard' | 'ThirdPartyMemberCard', required: Represents the type of a ticket redemption card base
      - `maskedCardNumber` string, required: Gets a masked representation of the card number
      - `memberName` OcapiV1PersonName: Represents the parts of a person's name
        - `givenName` string, nullable: Gets the given name
        - `familyName` string, nullable: Gets the family name
        - `middleName` string, nullable: Gets the middle or any additional name
  - `redemptionLimit` OcapiV1QuantityLimit, required: Represents a limited or unlimited quantity
    - `isUnlimited` boolean, required: Gets a value indicating whether the quantity is unlimited
    - `maximum` integer, nullable: Gets the maximum quantity allowed
    - `minimum` integer, required: Gets the minimum quantity allowed (0 by default)
  - `ticketTypeAvailabilities` OcapiV1OrdersTicketRedemptionCardsOrderTicketRedemptionCardTicketTypeAvailability[], required: Gets the list of order ticket redemption card ticket type availability entities
    - `ticketTypeId` string, required
    - `isAvailable` boolean, required
    - `availableQuantity` OcapiV1Quantity, required: Represents a limited or unlimited quantity
      - `isUnlimited` boolean, required: Gets a value indicating whether the quantity is unlimited
      - `value` integer, nullable: Gets the value
    - `unavailableMessage` OcapiV1Translatable: 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

## Other responses

- `400`: Request property is invalid or missing, or invalid order type/card.
- `401`: No member authenticated.
- `404`: Order 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)