---
title: "Get Job Invoices"
method: GET
path: "/jobs/{jobId}/invoices"
tags: ["jobs"]
---

# Get Job Invoices

`GET /jobs/{jobId}/invoices`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/jobs/{jobId}/invoices`
- Auth: HTTP bearer

Use this endpoint to get a list of invoices for the specified job.

## Path parameters

- `jobId` string, uuid, required

## Query parameters

- `pageSize` integer
- `pageStartIndex` integer
- `sortOrder` 'Ascending' | 'Descending'

## Response `200`

OK

- InvoiceCollection
  - `count` integer: The total number of items matching the current query.
  - `pageSize` integer: The requested or default page size.
  - `pageStartIndex` integer: The requested or default index of the first element to return.
  - `items` Invoice[]
    - `id` string, uuid: The unique identifier of the invoice.
    - `_link` string: The unique URI of the invoice for the specified Job.
    - `jobId` string, uuid: The unique identifier of the Job this invoice is for.
    - `invoiceNumber` string: The number of the invoice.
    - `invoiceSequence` number: The sequential number assigned to the invoice as its created.
    - `invoiceDate` string: The date/time the invoice in UTC format.
    - `dueDate` string: The due date/time the invoice in UTC format.
    - `currentInvoiceState` 'Paid' | 'Unpaid' | 'Void' | 'Draft': An identifier that provides an understanding of the state of the invoice.
    - `totalPrice` number: The total price of the invoice.
    - `balanceDue` number: The balance due left on the invoice.
    - `invoiceName` string: The user entered name of the invoice.
    - `createdDate` string: The date/time the invoice was created in UTC format.
    - `sortIndex` number: The order the invoice will appear in the list when sorted by invoice sequence.
    - `recordingStatus` string: Status of the invoice integration with external accounting integration.
    - `recordingClassification` string: The user selected classification of the invoice set when recording the invoice.
    - `sections` InvoiceSection[]
      - `id` string, uuid: The unique ID for the invoice section.
      - `invoiceWorksheetSectionType` 'Invoice' | 'Work Not Doing' | 'Supplements' | 'Discounts' | 'Upgrades' | 'Change Order' | 'Financial Worksheet' | 'Insurance Claim': An identifier for the type of invoice worksheet section.
      - `totalPrice` number: The total price of this invoice worksheet section.
      - `items` InvoiceItem[]
        - `id` string, uuid: The unique ID for the item.
        - `itemName` string: The name of the item.
        - `price` number: The user entered price for this item.
        - `totalPrice` number: Represents the contribution to the total of this invoice.
        - `parentItemId` string: The unique ID for the parent item of this item.
        - `hierarchySortOrder` number: The sort order of the item at the nested level it belongs to.
        - `lineItemAssignment` string: The user entered account classification the line was assigned to.
        - `referenceId` string, uuid: The unique ID for the Catalog reference.
        - `referenceType` 'SKU' | 'Product' | 'CustomeSKU' | 'Labor' | 'SKUAndLabor': the reference type for the item.
        - `tradeId` string, uuid: The unique ID for the trade of this item.

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `416`: Range Not Satisfiable.

## Changes

- **2026-11-03** `443924b00f43`: 5 breaking, 2 warning, 1 info
  - for the `query` request parameter `pageSize`, default value `25` was removed
  - the `allOf[subschema #2]/items/items/allOf[#/components/schemas/invoiceLink]/_link` response's property format changed from `uri` to no format for status `200`
  - removed the required property `status` from the response with the `416` status
  - removed the required property `title` from the response with the `416` status
  - …4 more

[Operation history](https://skmtc.dev/acculynx/apis/acculynx-api-v2/changes/jobs/:jobId/invoices/get.md)

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)