---
title: "Get a purchase order"
method: GET
path: "/vendor/purchase-orders/{poNumber}"
tags: ["Vendor — Purchase Orders"]
---

# Get a purchase order

`GET /vendor/purchase-orders/{poNumber}`

## Request

- Base URL: `https://app.zobrx.com/api/v1`
- URL: `https://app.zobrx.com/api/v1/vendor/purchase-orders/{poNumber}`
- Auth: HTTP bearer

## Path parameters

- `poNumber` string, required

## Headers

- `X-Zobrx-Integration-Id` string

## Response `200`

The purchase order.

- PurchaseOrder
  - `poNumber` string
  - `orderDate` string, date-time, nullable
  - `purchaseOrderState` string, nullable
  - `ackState` 'pending' | 'partially-acknowledged' | 'accepted' | 'rejected' | 'mixed'
  - `invoiceState` 'none' | 'partial' | 'invoiced' | 'credited'
  - `shipState` 'none' | 'partial' | 'shipped'
  - `buyingPartyKey` string, nullable
  - `buyingPartyName` string, nullable
  - `totalValue` Money: Integer minor units (paise) + currency.
    - `minor` integer
    - `currency` string
  - `itemCount` integer
  - `lines` PurchaseOrderLine[]
    - `itemSequenceNumber` integer
    - `vendorSku` string, nullable
    - `asin` string, nullable
    - `title` string, nullable
    - `orderedQuantity` integer
    - `acknowledgedQuantity` integer
    - `invoicedQuantity` integer
    - `shippedQuantity` integer
    - `netCost` Money: Integer minor units (paise) + currency.
      - `minor` integer
      - `currency` string

## Other responses

- `401`: Missing/invalid API key.
- `404`: Not found.

---

[API](https://skmtc.dev/zobrx/apis/zobrx-api.md) · [All operations](https://skmtc.dev/zobrx/apis/zobrx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zobrx/apis/zobrx-api/revisions/af90eac50273?raw)