---
title: "List purchase orders"
method: GET
path: "/vendor/purchase-orders"
tags: ["Vendor — Purchase Orders"]
---

# List purchase orders

`GET /vendor/purchase-orders`

## Request

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

POs Zobrx ingests from Amazon Vendor Central, newest first. Poll incrementally with `changedSince`. Requires scope `vendor:pos:read`.

## Query parameters

- `ackState` 'pending' | 'partially-acknowledged' | 'accepted' | 'rejected' | 'mixed'
- `changedSince` string, date-time
- `page` integer
- `limit` integer

## Headers

- `X-Zobrx-Integration-Id` string

## Response `200`

A page of purchase orders.

- object
  - `items` 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
  - `total` integer
  - `page` integer
  - `limit` integer

## Other responses

- `401`: Missing/invalid API key.

---

[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)