---
search:
  tags:
    - Purchase Orders
    - POST
seo:
  description: >-
    Review a customer purchase-order… Reference for the POST
    /v1/organizations/{orgId}/purchase-orders/preview endpoint in the Stashtab
    Vault Warehouse API.
sidebar:
  label: Preview a purchase order
  badge: POST
title: Preview a purchase order
type: openapi-operation
---
Review a customer purchase-order declaration without saving it. Player deposits require explicit eligibility for the selected immutable mode and a returnAddress. Test eligibility uses the current configured Test catalog. Live deposits keep their separate customer and deployment controls; Test setup does not activate Live intake or background deposit runs. The preview preserves each exact raw condition, or returns condition null when conditionDeferred leaves its declared grade unset. Sealed lines must specify sealedUnit. Graded-card deposits, cert lookups and exact-slab workflows are deferred from the current integration scope. Preview reserves no PO number or stock and creates no provider PO, real label purchase, charge or shipment.

`POST /v1/organizations/{orgId}/purchase-orders/preview`

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

- `expectedDate` (string<date> | null)
- `lines` (object[], required)
- `note` (string | null)
- `orderDate` (string<date> | null)
- `poNumber` (string)
- `registrationKind` (string)
- `depositRef` (string | null)
- `labelOrigin` (string | null)
- `labelService` (string | null)
- `returnAddress` (object | null)
- `tracking` (string | null)

Request body example:

```json
{
  "expectedDate": "2019-08-24",
  "lines": [
    {
      "productId": "string",
      "quantity": 1,
      "conditionDeferred": true,
      "slabs": [
        {
          "grader": "psa",
          "cert": "string"
        }
      ],
      "sealedUnit": "pack",
      "magneticSlab": "branded",
      "professionalGrading": true
    }
  ],
  "note": "string",
  "orderDate": "2019-08-24",
  "poNumber": "string",
  "registrationKind": "standard",
  "depositRef": "string",
  "labelOrigin": "string",
  "labelService": "string",
  "returnAddress": {
    "name": "string",
    "companyName": "string",
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "region": "string",
    "postalCode": "string",
    "countryCode": "string",
    "phone": "string",
    "email": "user@example.com"
  },
  "tracking": "string"
}
```

**Responses**

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

Response example, 200:

```json
{
  "data": {
    "preview": {
      "lines": [
        {
          "baseSku": "string",
          "condition": "string",
          "productId": "string",
          "quantity": 0,
          "sku": "string",
          "submittedName": "string"
        }
      ],
      "origin": "customer",
      "poNumber": "string",
      "registrationKind": "standard",
      "supplierId": "string",
      "warehouseRef": "string"
    }
  },
  "meta": {
    "requestId": "string"
  }
}
```
