---
title: "GET /customerInvoices/{invoiceId}"
method: GET
path: "/customerInvoices/{invoiceId}"
tags: ["Customer Invoices"]
---

# GET /customerInvoices/{invoiceId}

`GET /customerInvoices/{invoiceId}`

Returns a single invoice by ID with customer details and sections

## Path parameters

- `invoiceId` number, required

## Response `200`

Successful Response

- GetCustomerInvoiceByIdResponse
  - `result` string, required
  - `data` DetailedCustomerInvoice, required
    - `id` number, required
    - `jobId` number, required
    - `customerId` number, required
    - `attn` string, nullable, required
    - `title` string, required
    - `description` string, nullable, required
    - `invoiceNumber` string, nullable, required
    - `receiverEmail` string, nullable, required
    - `receiverFullName` string, nullable, required
    - `receiverPostalAddress` string, nullable, required
    - `dueDate` string, date-time, nullable, required
    - `dueDays` union, required
      - number
      - string
    - `invoiceDate` string, date-time, nullable, required
    - `paidAt` string, date-time, nullable, required
    - `subtotal` number, required
    - `taxValue` number, required
    - `totalPaid` number, nullable, required
    - `taxRate` number, required
    - `type` union, required
      - 'approved'
      - 'toBeApproved'
      - 'draft'
    - `status` union, required
      - 'unpaid'
      - 'draft'
      - 'voided'
      - 'paidDisputed'
      - 'unpaidDisputed'
      - 'paid'
    - `isSent` boolean, required
    - `isFinal` boolean, required
    - `createdAt` string, date-time, required
    - `fergusPayEnabled` boolean, required
    - `directDebitStatus` union, required
      - 'processing'
      - 'succeeded'
      - 'failed'
    - `links` Links[], required
      - `href` string, required
      - `rel` string, required
      - `type` 'GET' | 'POST' | 'PUT' | 'PATCH', required
    - `customer` object, required
      - `id` number, required
      - `customerFullName` string, required
      - `links` Links[], required
        - `href` string, required
        - `rel` string, required
        - `type` 'GET' | 'POST' | 'PUT' | 'PATCH', required
    - `sections` object[], required
      - `sectionId` number, required
      - `name` string, nullable, required
      - `sortOrder` number, nullable, required
      - `parentSectionId` number, nullable, required
      - `description` string, nullable, required
      - `lineItems` object[]
        - `priceBookLineItemId` number, nullable, required
        - `itemName` string, nullable, required
        - `itemQuantity` number, nullable, required
        - `unitOfMeasureSell` union, required
          - 'each'
          - 'hour'
          - 'day'
          - 'kilogram'
          - 'tonne'
          - 'litre'
          - 'bag'
          - 'sheet'
          - 'length'
          - 'box'
          - 'millimetre'
          - 'centimetre'
          - 'metre'
          - 'square_metre'
          - 'cubic_metre'
        - `itemPrice` number, nullable, required
        - `salesAccountId` number, nullable, required
        - `isLabour` boolean, nullable, required
        - `sortOrder` number, nullable, required
        - `discountRate` number, nullable, required
        - `isCombined` boolean, nullable, required
        - `combinedItemId` number, nullable, required
        - `customerInvoiceLineItemId` number, required
        - `itemDescription` string, nullable, required
        - `isCardPaymentFee` boolean, nullable, required
      - `sections` InvoiceSection[]
        - `sectionId` number, required
        - `name` string, nullable, required
        - `sortOrder` number, nullable, required
        - `parentSectionId` number, nullable, required
        - `description` string, nullable, required
        - `lineItems` object[]
          - `priceBookLineItemId` number, nullable, required
          - `itemName` string, nullable, required
          - `itemQuantity` number, nullable, required
          - `unitOfMeasureSell` union, required
            - 'each'
            - 'hour'
            - 'day'
            - 'kilogram'
            - 'tonne'
            - 'litre'
            - 'bag'
            - 'sheet'
            - 'length'
            - 'box'
            - 'millimetre'
            - 'centimetre'
            - 'metre'
            - 'square_metre'
            - 'cubic_metre'
          - `itemPrice` number, nullable, required
          - `salesAccountId` number, nullable, required
          - `isLabour` boolean, nullable, required
          - `sortOrder` number, nullable, required
          - `discountRate` number, nullable, required
          - `isCombined` boolean, nullable, required
          - `combinedItemId` number, nullable, required
          - `customerInvoiceLineItemId` number, required
          - `itemDescription` string, nullable, required
          - `isCardPaymentFee` boolean, nullable, required
        - `sections` InvoiceSection[]

## Other responses

- `4XX` — Client Request Errors
- `5XX` — Server Errors

---

[API](https://skmtc.dev/fergus/apis/fergus-api.md) · [All operations](https://skmtc.dev/fergus/apis/fergus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fergus/fergus-api/revisions/b4f232a22363/schema)