---
title: "Get Invoice"
method: GET
path: "/invoices/{invoiceId}"
tags: ["invoices"]
---

# Get Invoice

`GET /invoices/{invoiceId}`

Use this endpoint to get a specific Invoice.

## Path parameters

- `invoiceId` string, uuid, required

## Response `200`

OK

- Invoice
  - `id` string, uuid — Unique UUID identifier for invoice record
  - `_link` string, uri
  - `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` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values

---

[API](https://skmtc.net/acculynx/apis/acculynx-api-v2.md) · [All operations](https://skmtc.net/acculynx/apis/acculynx-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acculynx/acculynx-api-v2/versions/3a9e3886e400/schema)