---
search:
  tags:
    - Orders
    - POST
seo:
  description: >-
    Reviews a proposed order without creating it.… Reference for the POST
    /v1/organizations/{orgId}/orders/preview endpoint in the Stashtab Vault
    Warehouse API.
sidebar:
  label: Preview an order and validate its address
  badge: POST
title: Preview an order and validate its address
type: openapi-operation
---
Reviews a proposed order without creating it. For a redemption in Test or Live, set orderKind to redemption to check the exact destination. A rejected, unavailable or unconfirmed address cannot advance. Recheck any corrections before placing the order; a quote or autoAdvance alone does not authorize creation. Set rateContext.physicalSource to &#123;&#125; and copy physicalSource.selected unchanged as fulfillmentSource. Pass the same deliveryConfirmation to preview and quote; an omitted value means none. For priced shipping, quote the same recipient, products and source, then preview the exact named service and pass the quote selection as shippingQuote. Preview again when any input changes. Existing unquoted callers can pass preview's requestedService.selected and requestedService.review as requestedShippingService and requestedShippingServiceReview.

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

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

- `deliveryConfirmation` (string)
- `lines` (object[], required)
- `orderKind` (string)
- `rateContext` (object, required)
- `recipient` (object, required)
- `selectedAddress` (string, required)

Request body example:

```json
{
  "deliveryConfirmation": "none",
  "lines": [
    {
      "declaredUnitValue": {
        "amount": "string"
      },
      "productId": "string",
      "quantity": 1
    }
  ],
  "orderKind": "redemption",
  "rateContext": {
    "carrierIds": [
      "string"
    ],
    "shipFrom": {
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "company": "string",
      "country": "string",
      "email": "string",
      "name": "string",
      "phone": "string",
      "postalCode": "string",
      "region": "string"
    }
  },
  "recipient": {
    "addressLine1": "string",
    "addressLine2": "string",
    "city": "string",
    "company": "string",
    "country": "string",
    "email": "string",
    "name": "string",
    "phone": "string",
    "postalCode": "string",
    "region": "string"
  },
  "selectedAddress": "edited"
}
```

**Responses**

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

Response example, 200:

```json
{
  "data": {
    "address": {
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "company": "string",
      "country": "string",
      "email": "string",
      "name": "string",
      "phone": "string",
      "postalCode": "string",
      "region": "string",
      "candidate": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "company": "string",
        "country": "string",
        "email": "string",
        "name": "string",
        "phone": "string",
        "postalCode": "string",
        "region": "string"
      },
      "provider": {
        "code": "string",
        "field": "string",
        "outcome": "accepted",
        "rateCount": 0,
        "requestId": "string"
      },
      "reason": "string",
      "selected": "edited",
      "state": "invalid-required-field"
    },
    "autoAdvance": true,
    "eligibility": "ineligible",
    "issues": [
      "string"
    ],
    "products": [
      {
        "productId": "string",
        "revision": "string",
        "sku": "string",
        "weight": {
          "unit": "string",
          "value": 0
        }
      }
    ],
    "reviewId": "string",
    "requestedService": {
      "state": "ready",
      "selected": "string",
      "choices": [
        "string"
      ],
      "review": "string",
      "reason": "string"
    },
    "physicalSource": {
      "state": "unavailable",
      "selected": {
        "configurationRevision": "string",
        "sourceSignature": "string",
        "physicalOriginEquivalenceRef": "string",
        "v1WarehouseId": 1
      },
      "choices": [
        {
          "selection": {
            "configurationRevision": "string",
            "sourceSignature": "string",
            "physicalOriginEquivalenceRef": "string",
            "v1WarehouseId": 1
          },
          "address": {
            "addressLine1": "string",
            "addressLine2": "string",
            "city": "string",
            "company": "string",
            "country": "string",
            "email": "string",
            "name": "string",
            "phone": "string",
            "postalCode": "string",
            "region": "string"
          }
        }
      ],
      "reason": "string"
    }
  },
  "meta": {
    "requestId": "string"
  }
}
```
