Skip to main content

PurchaseOrderLineItem

A line item nested under include=line_items on the purchase order read endpoints (GET /v1/entities/{entity_id}/purchase_orders, GET /v1/entities/{entity_id}/purchase_orders/{uuid}). Money fields are JSON numbers.

client_line_idstringnullable
Example: null
skustringnullable
Example: WIDGET-1
barcodestringnullable
Example: null
titlestringnullable
Example: Widget
image_urlstringnullable
Example: null
unit_costnumbernullable
Example: 4.5
line_totalnumbernullable
Example: 45
product_idstringnullable
Example: gid://shopify/Product/1
variant_idstringnullable
Example: gid://shopify/ProductVariant/1
location_idstringnullable
Example: gid://shopify/Location/1
location_namestringnullable
Example: Main Warehouse
tax_percentstringnullable

A tax rate, not an amount, so unlike the money fields it is returned as a string rather than a number. Parse it before doing arithmetic with it.

Example: 0.0
supplier_skustringnullable
Example: null
notestringnullable
Example: null
variant_titlestringnullable
Example: Default Title
quantity_orderedinteger
Example: 10
inventory_item_idstringnullable
Example: gid://shopify/InventoryItem/1
positioninteger
Example: 1
added_during_receivingboolean
Example: false
created_atstring<date-time>
Example: 2026-06-01T12:00:00.000Z
updated_atstring<date-time>
Example: 2026-06-01T12:00:00.000Z
PurchaseOrderLineItem
{
"client_line_id": null,
"sku": "WIDGET-1",
"barcode": null,
"title": "Widget",
"image_url": null,
"unit_cost": 4.5,
"line_total": 45,
"product_id": "gid://shopify/Product/1",
"variant_id": "gid://shopify/ProductVariant/1",
"location_id": "gid://shopify/Location/1",
"location_name": "Main Warehouse",
"tax_percent": "0.0",
"supplier_sku": null,
"note": null,
"variant_title": "Default Title",
"quantity_ordered": 10,
"inventory_item_id": "gid://shopify/InventoryItem/1",
"position": 1,
"added_during_receiving": false,
"created_at": "2026-06-01T12:00:00.000Z",
"updated_at": "2026-06-01T12:00:00.000Z"
}