---
title: "Retrieve a single Invoice"
method: GET
path: "/v2/invoices/{id}"
tags: ["Invoices"]
---

# Retrieve a single Invoice

`GET /v2/invoices/{id}`

Retrieves a single Invoice by its ID.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

The requested Invoice.

- ResponseInvoiceV2Dto
  - `id` string — The ID of the invoice (prefix `IV-`).
  - `uuid` string — The UUID of the invoice.
  - `serialId` number — The serial ID of the invoice.
  - `name` string — The name of the invoice.
  - `notes` string — The invoice note.
  - `jobId` string — The ID of the associated job (prefix `JOB-`).
  - `discountAmount` number — The invoice discount amount.
  - `subTotal` number — The subtotal of the invoice before tax and discounts.
  - `taxableAmount` number — The taxable amount of the invoice.
  - `taxPercent` number — The tax percentage of the invoice.
  - `taxAmount` number — The tax amount of the invoice.
  - `costing` number — The cost amount of the invoice.
  - `techExpenses` number — The technician expenses of the invoice.
  - `tipAmount` number — The tip amount of the invoice.
  - `totalPrice` number — The total price of the invoice.
  - `amountDue` number — The amount due for the invoice.
  - `amountDueDate` string, date-time — The date and time when the invoice amount is due.
  - `lineItems` ResponseInvoiceLineItemV2Dto[] — A list of invoice line items.
    - `id` string — The ID of the invoice line item (prefix `ILI-`).
    - `productId` number — The product ID of the item from which this line item was created.
    - `name` string — The name of the line item.
    - `description` string — The description of the line item.
    - `price` number — The price of the line item.
    - `quantity` number — The quantity of the line item.
    - `total` number — The total of the line item.
    - `cost` number — The cost of the line item.
    - `taxable` boolean — Whether the line item is taxable.
    - `discountable` boolean — Whether the line item is discountable.
    - `inventoryManaged` boolean — Whether the line item is managed by inventory.
    - `inventorySync` boolean — Whether the line item is synced to inventory.
    - `optionalConverted` boolean — Whether the line item was an optional item.
  - `payments` ResponseGenericPaymentV2Dto[] — The payments of the invoice.
    - `id` string — The ID of the payment (prefix `PAY-`).
    - `type` string — The type of the payment.
    - `amount` number — The amount of the payment.
    - `tipAmount` number — The tip amount.
  - `attachments` ResponseGenericAttachmentV2Dto[] — The attachments of the invoice.
    - `id` string — The ID of the attachment (prefix `FLE-`).
    - `name` string — The name of the attachment.
    - `fileUrl` string — The URL of the attachment.
  - `signatureImage` ResponseGenericSignatureV2Dto
    - `id` string — The ID of the signature image (prefix `IMG-`).
    - `signedByName` string — The name of the person who signed.
    - `imageUrl` string — The URL of the signature image.
  - `updated` string, date-time — The date and time the invoice was last updated.
  - `created` string, date-time — The date and time the invoice was created.

## Other responses

- `400` — The provided ID is not a valid invoice ID.
- `401` — Missing or invalid authentication token.
- `404` — Invoice not found.

---

[API](https://skmtc.net/workiz/apis/developer-api.md) · [All operations](https://skmtc.net/workiz/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workiz/developer-api/revisions/14666f4db0f8/schema)