Purchase Orders

List purchase order items

Returns the items in a purchase order.

get/purchase-orders/{purchaseOrderId}/items

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/purchase-orders/{purchaseOrderId}/items
  • Auth: HTTP bearer

Path parameters

purchaseOrderIdstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

Example:txn_8f2a1c9e

Purchase order ID.

Query parameters

limitinteger

Maximum number of items to return on a page. Capped at 100.

cursorstring

Cursor from the previous page's nextCursor. Use it with the same filters and sort.

Response

A page of purchase-order items.

nextCursorstring nullable

Cursor for the next page. Pass it as cursor with the same filters and sort. Null on the last page.

countinteger

Total number of matches. Included when withCount=true.

truncatedboolean

Whether the page contains fewer results than requested.

Example response

{
  "data": [
    {
      "id": "poi_1a",
      "purchaseOrderId": "po_8f2a1c9e",
      "lineNumber": "1",
      "description": "Alexa Mini LF body",
      "budgetLineId": "bud_5510",
      "qty": "5",
      "unit": "day",
      "rate": "25000",
      "amount": 125000,
      "sort": "1000"
    }
  ],
  "nextCursor": "eyJpZCI6InR4bl84ZjJhMWM5ZSJ9"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.