---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Optional declaredUnitValues… Reference for the POST
    /v1/organizations/{orgId}/orders/redemptions/pack-preview endpoint in the
    Stashtab Vault Warehouse API.
sidebar:
  label: Preview a whole pack or selected cards for redemption
  badge: POST
title: Preview a whole pack or selected cards for redemption
type: openapi-operation
---
Optional declaredUnitValues accept one &#123;productId, amount&#125; entry per distinct selected product, in USD per unit. Repeated copies share that unit value. The returned lines include declaredUnitValue, and the returned pack retains the overrides. Duplicate or unselected product entries are refused. Values do not change the frozen source digest or catalog defaults. Preview a whole published pack or selected one-based cardOrdinals within the current organization and verified deployment. Omit cardOrdinals for the whole pack; each selected ordinal may appear once. The response includes the frozen source revision and digest, exact catalog products and recorded conditions, and quantity lines that combine repeated exact variants. Pass the returned lines into createRedemptionOrder for the whole pack or the previewed subset. To select cards after fetching the whole pack, use their productId and condition from cards and combine repeated products into quantities. A Live caller using the pack input can pass the returned pack object unchanged instead of lines. Preview and quote the resolved lines with the same recipient and physical source before submitting a priced redemption. A stale revision or digest requires another preview; an exact submission-key replay preserves the selected source identities. This convenience does not grant protocol authority, allocate a serialized physical copy, restore a token or escrow, or authorize unrevealed content. Test can preview explicitly copied published packs in its active generation. The copy preserves recorded raw conditions and resolves separate Test catalog products with sufficient synthetic stock. Use the returned explicit lines for Test redemption; frozen pack creation remains Live-only. Missing or revoked Test copies never fall back to Live.

`POST /v1/organizations/{orgId}/orders/redemptions/pack-preview`

**Request body** (`application/json`, required)

- `cardOrdinals` (integer[])
- `declaredUnitValues` (object[])
- `deploymentRef` (string, required)
- `packReference` (string, required)

Request body example:

```json
{
  "cardOrdinals": [
    1,
    3
  ],
  "declaredUnitValues": [
    {
      "amount": "9.25",
      "productId": "variant_example_nm"
    }
  ],
  "deploymentRef": "0x1111111111111111111111111111111111111111111111111111111111111111",
  "packReference": "0x2222222222222222222222222222222222222222222222222222222222222222"
}
```

**Responses**

- `200` — Success
- `default` — Error

Response example, 200:

```json
{
  "data": {
    "cards": [
      {
        "condition": "nm",
        "ordinal": 1,
        "productId": "variant_example_nm"
      },
      {
        "condition": "nm",
        "ordinal": 3,
        "productId": "variant_example_nm"
      }
    ],
    "lines": [
      {
        "declaredUnitValue": {
          "amount": "9.25"
        },
        "condition": "nm",
        "productId": "variant_example_nm",
        "quantity": 2
      }
    ],
    "pack": {
      "cardOrdinals": [
        1,
        3
      ],
      "declaredUnitValues": [
        {
          "amount": "9.25",
          "productId": "variant_example_nm"
        }
      ],
      "deploymentRef": "0x1111111111111111111111111111111111111111111111111111111111111111",
      "packReference": "0x2222222222222222222222222222222222222222222222222222222222222222",
      "sourceContentRevision": 4,
      "sourceDigest": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  },
  "meta": {
    "requestId": "example-previewPackRedemption"
  }
}
```
