---
title: "Get customer invoice by ID"
method: GET
path: "/v3/customers/{id}/invoices/{invoiceId}"
tags: ["Customers"]
---

# Get customer invoice by ID

`GET /v3/customers/{id}/invoices/{invoiceId}`

## Path parameters

- `id` string, required
- `invoiceId` string, required

## Response `200`

The invoice

- object
  - `payload` object, required — Response payload, will be empty when success is false
    - `id` string, required — Unique identifier for the invoice
    - `issueDate` string, required — Date the invoice was issued
    - `dueDate` string, required — Date the invoice is due
    - `sentDate` string — Date the invoice was sent to the customer
    - `createdAt` string, required — Date the invoice was created
    - `status` 'DRAFT' | 'APPROVED' | 'SENT' | 'PAID' | 'PARTIALLY_PAID' | 'VOID' | 'SENT_OFF_TABS' | 'PENDING' | 'DONE', required — Current status of the invoice
    - `invoiceNumber` string — Invoice number
    - `memo` string — Invoice memo
    - `customFields` string[] — Invoice custom fields
    - `source` 'TABS' | 'QBO' | 'NETSUITE' | 'AVALARA' | 'SALESFORCE' | 'HUBSPOT' | 'STRIPE' | 'RILLET' | 'SAGE_INTACCT' | 'CAMPFIRE', required — Source of the invoice
    - `customerId` string, required — ID of the customer this invoice belongs to
    - `originalDueDate` string, required — Original due date before any modifications
    - `originalIssueDate` string, required — Original issue date before any modifications
    - `total` number, required — Total amount in currency associated with the customer
    - `balanceRemaining` number, required — Remaining balance in currency associated with the customer
    - `externalIds` ExternalIdV3Dto[], required — List of external identifiers
      - `type` 'QUICKBOOKS' | 'NETSUITE' | 'RILLET' | 'SAGE_INTACCT' | 'SALESFORCE' | 'HUBSPOT' | 'AVALARA' | 'ANROK' | 'STRIPE', required
      - `id` string, required — External identifier value
    - `lineItems` InvoiceItemV3Dto[], required — Line items on this invoice
      - `id` string, required — Unique identifier for the invoice item
      - `name` string, required — Name of the invoice item
      - `description` string, required — Description of the invoice item
      - `quantity` number, required — Quantity of items
      - `unitPrice` number, required — Unit price in currency associated with the customer
      - `subtotal` number, required — Subtotal before discounts in currency associated with the customer
      - `discountTotal` number, required — Total discount amount for this line item in currency associated with the customer
      - `total` number, required — Total in currency associated with the customer
      - `salesTaxRate` string, nullable, required — Sales tax rate percentage for this line item
      - `item` ItemV3Dto, required
        - `id` string, required — Unique identifier for the item
        - `name` string, required — Name of the item
        - `displayName` string, nullable — Display name of the item, as shown in the Tabs app. Null when not set.
        - `externalIds` ExternalIdV3Dto[], required — List of external identifiers associated with the item
          - `type` 'QUICKBOOKS' | 'NETSUITE' | 'RILLET' | 'SAGE_INTACCT' | 'SALESFORCE' | 'HUBSPOT' | 'AVALARA' | 'ANROK' | 'STRIPE', required
          - `id` string, required — External identifier value
    - `paymentLink` string — Payment link for the invoice (Optional)
    - `poNumber` string, required — PO number
    - `paidOn` string, nullable, required — Date the invoice was fully paid
    - `uncollectibleOn` string, nullable, required — Date the invoice was marked as uncollectible
    - `lastUpdatedAt` string, required — Timestamp of last update
  - `success` boolean, required — Boolean with true=success, false=failure
  - `message` string, required — Plain-text description of the result
  - `error` IntegratorsApiError, required
    - `code` number, required — API response code
    - `message` string, required — API response message
    - `details` object — Additional details about the error

## Other responses

- `404` — Invoice not found

---

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