---
title: "Get an invoice"
method: GET
path: "/invoices/{id}"
tags: ["Invoices"]
---

# Get an invoice

`GET /invoices/{id}`

**Plan: Paid API.**

May also be looked up by `txn_number` query param instead of the id.

## Query parameters

- `txn_number` string

## Response `200`

OK

- Invoice — Single invoice with line items and signatures.
  - `id` string, uuid
  - `name` string
  - `title` string
  - `txnNumber` string
  - `txnDate` string, date, nullable
  - `dueDate` string, date, nullable
  - `shippingDate` string, date, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `workflowState` string, nullable
  - `totalPriceWithTaxInDollars` number, nullable — US dollars.
  - `balanceInDollars` number, nullable — US dollars.
  - `totalPaymentsInDollars` number, nullable — US dollars.
  - `customerPoNumber` string, nullable
  - `customerPoDate` string, date, nullable
  - `changed` 'Yes' | 'No'
  - `accountingSyncDate` 'Yes' | 'No'
  - `lastNote` string, nullable
  - `pm` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `projectManager` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `designer` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `primaryContact` ContactRef — Contact reference returned by some transactions (name, phone, id - no initials).
    - `id` string, uuid
    - `name` string, nullable
    - `phoneWithExt` string, nullable
  - `primarySalesRep` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `company` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `divisionId` string, uuid, nullable
  - `division` object — Full division record (all columns), present only when the invoice has a division.
  - `lineItems` InvoiceLineItem[]
    - `id` string, uuid
    - `position` integer
    - `name` string, nullable
    - `description` string, nullable
    - `fullDescription` string, nullable
    - `quantity` number, nullable
    - `volumeDiscountPercent` number, nullable
    - `volumeDiscountInDollars` number, nullable
    - `rangeDiscountPercent` number, nullable
    - `rangeDiscountInDollars` number, nullable
    - `costInDollars` number, nullable — US dollars.
    - `suggestedPriceInDollars` number, nullable — US dollars.
    - `priceInDollars` number, nullable — US dollars.
    - `totalCostInDollars` number, nullable — US dollars.
    - `totalPriceInDollars` number, nullable — US dollars.
    - `totalTaxInDollars` number, nullable — US dollars.
    - `workflowState` string, nullable
    - `productId` string, uuid, nullable
    - `productType` string, nullable
    - `productName` string, nullable
    - `saleType` string, nullable
    - `taxable` boolean
    - `taxName` string, nullable
    - `taxRate` number, nullable
    - `priceOverride` boolean, nullable
    - `incomeCoaAccountId` string, uuid, nullable
    - `incomeAccountName` string, nullable
    - `cogCoaAccountId` string, uuid, nullable
    - `cogAccountName` string, nullable
    - `cogAccountNumber` string, nullable
    - `parentLineItemId` string, uuid, nullable
  - `signatures` Signature[]
    - `name` string
    - `location` string, nullable
    - `signatureUrl` string, nullable
    - `createdAt` string, date-time

## Other responses

- `401` — Missing/expired credentials, an index request without a required filter, or the plan does not include this endpoint.
- `404` — Not found.

---

[API](https://skmtc.net/shopvox/apis/shopvox-public-api.md) · [All operations](https://skmtc.net/shopvox/apis/shopvox-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopvox/shopvox-public-api/revisions/7ac1ff5d444a/schema)