---
search:
  tags:
    - Purchase Order Imports
    - POST
seo:
  description: >-
    Preview grouped purchase-order… Reference for the POST
    /v1/organizations/{orgId}/purchase-order-imports/preview endpoint in the
    Stashtab Vault Warehouse API.
sidebar:
  label: Preview grouped purchase-order CSV or JSON
  badge: POST
title: Preview grouped purchase-order CSV or JSON
type: openapi-operation
---
`POST /v1/organizations/{orgId}/purchase-order-imports/preview`

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

- `source` (object, required)

Request body example:

```json
{
  "source": {
    "format": "json",
    "groups": [
      {
        "expectedDate": "2026-11-01",
        "lines": [
          {
            "condition": "nm",
            "name": "Demo card sleeve",
            "quantity": 12,
            "sku": "PO-DEMO-SLEEVE",
            "sourceRow": 1
          }
        ],
        "note": null,
        "orderDate": "2026-10-01",
        "poNumber": "PO-DEMO-1"
      }
    ]
  }
}
```

**Responses**

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

Response example, 200:

```json
{
  "data": {
    "groups": [
      {
        "eligible": true,
        "expectedDate": "2026-11-01",
        "groupId": "dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
        "issues": [],
        "lines": [
          {
            "condition": "nm",
            "mapping": "matched",
            "name": "Demo card sleeve",
            "productId": "product_po_demo",
            "quantity": 12,
            "sku": "PO-DEMO-SLEEVE",
            "sourceRow": 1
          }
        ],
        "note": null,
        "orderDate": "2026-10-01",
        "poNumber": "PO-DEMO-1",
        "revision": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "sourceRows": [
          1
        ]
      }
    ],
    "importId": "ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
    "sourceHash": "1111111111111111111111111111111111111111111111111111111111111111"
  },
  "meta": {
    "requestId": "example-previewPurchaseOrderImport"
  }
}
```
