---
search:
  tags:
    - Purchase Orders
    - POST
seo:
  description: >-
    Create a customer purchase-order declaration… Reference for the POST
    /v1/organizations/{orgId}/purchase-orders endpoint in the Stashtab Vault
    Warehouse API.
sidebar:
  label: Create a customer purchase order
  badge: POST
title: Create a customer purchase order
type: openapi-operation
---
Create a customer purchase-order declaration in the selected immutable mode. Player deposits require explicit eligibility for that mode and a returnAddress for ship-back. Test eligibility admits configured raw-condition and sealed pack/box/case declarations using isolated inventory and a synthetic prepaid-label association. Live deposits keep their separate customer and deployment controls; Test setup does not activate Live intake or background deposit runs. A raw line may set conditionDeferred to leave its declared grade unset; a sealed line must specify sealedUnit. Use the returned local PO ID to read deposit-results after assessment and acceptance. An exact submission-key replay returns its original receipt; changed intent conflicts. Graded-card deposits, cert lookups and exact-slab workflows are deferred from the current integration scope. Test creates no provider PO, real label purchase, charge or shipment.

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

**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)
- `submissionKey` (string, required)
- `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"
  },
  "submissionKey": "stringst",
  "tracking": "string"
}
```

**Responses**

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

Response example, 200:

```json
{
  "data": {
    "effects": [
      "string"
    ],
    "operationId": "string",
    "outcome": "confirmed",
    "purchaseOrder": {
      "declarationRevision": 1,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "poNumber": "string",
      "providerPoRef": "string",
      "deposit": {
        "adapter": {
          "id": "string",
          "label": "string",
          "providerVerified": false
        },
        "depositRef": "string",
        "label": {
          "documentId": "4704590c-004e-410d-adf7-acb7ca0a7052",
          "labelRef": "string",
          "providerRef": "string",
          "tracking": "string"
        },
        "source": "player_deposit"
      },
      "slabs": [
        {
          "cert": "string",
          "grader": "psa",
          "lookup": "verified"
        }
      ]
    }
  },
  "meta": {
    "requestId": "string"
  }
}
```
