---
title: "Gets a list of line items that belong to the specified purchase order"
method: GET
path: "/v1/finance/purchaseorders/{purchaseOrderId}/lineItems"
tags: ["PurchaseOrders"]
---

# Gets a list of line items that belong to the specified purchase order

`GET /v1/finance/purchaseorders/{purchaseOrderId}/lineItems`

Retrieve a paged list of line items for a purchase order (required scope finance:read)

## Path parameters

- `purchaseOrderId` integer, required

## Query parameters

- `pageNumber` integer
- `pageSize` integer

## Headers

- `Customer-Id` integer, required

## Response `200`

OK

- PagedResponseReadPurchaseOrderLineItemModel — A paged collection of items
  - `items` ReadPurchaseOrderLineItemModel[] — The items returned for the requested page
    - `id` integer — The unique identifier associated with the purchase order line item
    - `purchaseOrderId` integer, nullable — The unique identifier of the purchase order associated with the purchase order line item
    - `contactId` integer, nullable — The unique identifier of the contact associated with the purchase order line item
    - `createdAt` string, date-time — The date and time when the purchase order line item was created
    - `quantity` number, double — The quantity of the line item
    - `description` string — Description of the purchase order line item
    - `taxId` integer, nullable — VAT / Tax identifier associated with the line item
    - `taxPercentage` number, double — Tax percentage applied to the line item (GET only, never null). Defaults to 0 when no tax is applied
    - `unitCost` number, double, nullable — Unit cost of the item (cannot be negative)
    - `unitSellingPrice` number, double — Unit selling price of the item (cannot be negative)
    - `taxAmount` number, double, nullable — Tax amount for the line item (GET only)
    - `grossAmount` number, double, nullable — Gross amount (formerly NetPrice internal) of the line item (GET only)
    - `nominalCodeId` integer, nullable — Nominal code identifier
    - `departmentCodeId` integer, nullable — Department code identifier
  - `pageNumber` integer — The page number of the response where 1 is the first page
  - `pageSize` integer — The number of items requested for the current page
  - `pageItemCount` integer — The number of items returned in the current page

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bigchange/apis/bigchange-dx.md) · [All operations](https://skmtc.net/bigchange/apis/bigchange-dx/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigchange/bigchange-dx/revisions/916e669fc527/schema)