---
title: "Gets a list of job group line items that belong to the specified job group"
method: GET
path: "/v1/jobGroups/{jobGroupId}/lineItems"
tags: ["JobGroups"]
---

# Gets a list of job group line items that belong to the specified job group

`GET /v1/jobGroups/{jobGroupId}/lineItems`

## Request

- Base URL: `https://api.bigchange.com`
- URL: `https://api.bigchange.com/v1/jobGroups/{jobGroupId}/lineItems`
- Auth: HTTP bearer

Retrieve a paged list of line items for a job group (required scope jobs:read)

## Path parameters

- `jobGroupId` integer, required

## Query parameters

- `sortBy` 'createdAt': JobGroupLineItemSortOptions enum<p>Possible values:</p><ul><li><b>createdAt</b>: JobGroupLineItemSortOptions CreatedAt</li></ul>
- `direction` 'ascending' | 'descending': Represents the direction in which sorting should be applied<p>Possible values:</p><ul><li><b>ascending</b>: Indicates ascending sorting order</li><li><b>descending</b>: Indicates descending sorting order</li></ul>
- `pageNumber` integer
- `pageSize` integer

## Headers

- `Customer-Id` integer, required

## Response `200`

OK

- PagedResponseReadJobGroupLineItemModel: A paged collection of items
  - `items` ReadJobGroupLineItemModel[]: The items returned for the requested page
    - `id` integer: The unique identifier of the line item
    - `jobId` integer, nullable: The unique identifier of the job the line item is associated with
    - `jobGroupId` integer, nullable: The unique identifier of the job group associated with the job group line item
    - `contactId` integer, nullable: Contact id that the costs are charged to
    - `createdAt` string, date-time: Creation date of the invoice item that this line belongs to
    - `lineItemType` 'freeText' | 'predefined' | 'stockItem' | 'worksheet' | 'drivingPlanned' | 'drivingActual' | 'workPlanned' | 'workActual' | 'expense' | 'invoice' | 'stock' | 'ratingTable': Represents the type of a purchase order line item<p>Possible values:</p><ul><li><b>freeText</b>: A free text line item</li><li><b>predefined</b>: A predefined invoicing item</li><li><b>stockItem</b>: A stock item line item</li><li><b>worksheet</b>: A worksheet line item</li><li><b>drivingPlanned</b>: A driving planned line item</li><li><b>drivingActual</b>: A driving actual line item</li><li><b>workPlanned</b>: A work planned line item</li><li><b>workActual</b>: A work actual line item</li><li><b>expense</b>: An expense line item</li><li><b>invoice</b>: An invoice line item</li><li><b>stock</b>: A stock line item</li><li><b>ratingTable</b>: A rating table line item</li></ul>
    - `quantity` number, double: Quantity of the line item
    - `description` string: Description of the line item
    - `taxId` integer, nullable: Id of the vat/tax rate applied to this item
    - `taxPercentage` number, double: Percentage of tax applied to this item
    - `unitCost` number, double, nullable: Cost of the line item
    - `unitSellingPrice` number, double: Price of each individual unit associated to the line item
    - `taxAmount` number, double, nullable: Tax amount associated to the line item (GET only)
    - `grossAmount` number, double, nullable: Net price associated to the line item
    - `nominalCodeId` integer, nullable: Id of the associated nominal code
    - `departmentCodeId` integer, nullable: Id of the associated department code
  - `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.dev/bigchange/apis/bigchange-dx.md) - [All operations](https://skmtc.dev/bigchange/apis/bigchange-dx/llms.txt) - [OpenAPI document](https://skmtc.dev/bigchange/apis/bigchange-dx/revisions/b262bfdb1dd0?raw)
