---
title: "Invoices · Practice Manager API · COUNT Partner API"
description: "Invoices, estimates, and credit memos share the same routes, distinguished by invoiceType. Every invoice object includes a derived status field (draft…"
canonical: "https://developers.getcount.com/practice-manager/reference/invoices"
source: "https://developers.getcount.com/practice-manager/reference/invoices"
---
Practice Manager API

# Invoices

Invoices, estimates, and credit memos share the same routes, distinguished by invoiceType. Every invoice object includes a derived status field (draft, approved, sent, unpaid, partial, paid, overdue, void) alongside the raw isDraft / approved / isSent / paymentStatus flags. All references use UUIDs.

Last updated 2026-11-18

Some fields work differently in US and NZ workspaces

Showing US sales tax and NZ GST rules.

## Overview

The Invoices API lets your integration create, list, update, approve, send, and delete invoices, estimates, and credit memos in a workspace. All document types share the same `/firm-partners/workspace/invoices` routes and are distinguished by `invoiceType` (`invoice`, `estimate`, or `memo`).

Every invoice-shaped object includes a derived `status` field (for example draft, approved, sent, unpaid, partial, paid, overdue, void) computed from `isDraft`, `approved`, `isSent`, and `paymentStatus`. Partner responses expose UUIDs as `id` and strip internal numeric foreign keys. For migrations you may pass inline `customer` or per-line `product` objects instead of UUIDs, or set `isDraft: false` to post revenue journals in one step.

## Key concepts

### Document types

Set `invoiceType` to `invoice` (default), `estimate`, or `memo` (credit memo). Credit memos cannot be recurring — use Recurring Invoice Templates for scheduled invoices only.

### Derived status

Partner responses include a computed `status` alongside raw flags. After send, an open unpaid invoice may surface as `sent` rather than `unpaid`. See the backend `computePartnerInvoiceStatus` helper for the full mapping.

### Line item taxes

On create, `unitPrice` is copied to `price` when omitted. A line's tax codes go in `taxes` (tax UUIDs from List tax codes); omit it to take the product's codes. `nonTaxable` behaves differently in US and NZ workspaces — see the US and NZ cards.

### US· Sales taxLine taxes

Each line charges the sales tax codes in its `taxes` array, or the product's codes when `taxes` is omitted. `nonTaxable: true` keeps the code but charges no tax, so the sale reports as Non-Taxable under that code. A tax-exempt customer's taxed lines are raised Non-Taxable unless the line sends `customerExemptionOverridden: true`.

### NZ· GSTLine GST codes

Each line carries a GST code in `taxes`: `15% GST on Income` (standard-rated), `Zero Rated` (counted in GST return boxes 5 and 6), or `No GST` (left off the GST return). Zero Rated and No GST are both 0% but are different codes. Pick them by UUID from List tax codes. `nonTaxable: true` and `taxes: []` both raise the line with no code at all, which is never a zero-rated supply.

### Foreign-currency rate

A document in another currency is booked at the spot rate for its date, from Open Exchange Rates unless the workspace has its own rate for that currency. To use your rate instead, send `bookingExchangeRate` with `exchangeRateSource: "user"`. The document keeps its face amounts in its own currency; responses also carry `bookingExchangeRate`, `exchangeRateDate`, `exchangeRateSource` (`OXR`, `user`, `bank` or `date_override`) and `baseTotal`, the total in the workspace currency.

### Revaluation and currency gains

COUNT revalues open foreign-currency AR, AP and foreign-currency accounts at the closing rate at each month end, posting to Unrealised Currency Gain/Loss and reversing on the first day of the next month. When a payment settles a foreign document at a different rate, the difference posts to Realised Currency Gain/Loss. Both accounts are created automatically, so there is nothing to post yourself.

### Free-text lines

A line with no `productUuid` is a free-text line — the app's "Custom" line. It needs `categoryAccountUuid` (the income account it posts to), carries its item name in `name` and any detail in `description`, and takes only the taxes it names. Product lines may also send `categoryAccountUuid` to post to a different income account than the product's own. Unrecognized line fields are ignored and reported in `_partnerWarnings`.

### Lifecycle and allowed operations

Typical flow: create (draft) → approve → send → pay via assign-to-bills-invoices. update/delete work on drafts only; send requires approval; there is no revert-to-draft API — use credit memos to correct approved invoices.

### Credit application

Apply credit memos to invoices with the apply-multiple-credit and apply-credit-to-multiple-invoices routes. All IDs in those bodies are partner invoice UUIDs (the `id` field on invoice/memo objects).

## The invoice object

Core fields returned on invoice, estimate, and credit memo records.

#### Attributes

`id` uuid

Document identifier (UUID). Use in path parameters.

`invoiceNumber` string

Human-readable document number.

`invoiceType` enum

Document type.

One of: `invoice`, `estimate`, `memo`

`customerUuid` uuid

UUID of the customer this document belongs to.

`date` date

Document date (ISO).

`dueDate` date

Due date (ISO), when applicable.

`currency` string

ISO 4217 currency code.

`status` string

Derived lifecycle status (draft, approved, sent, unpaid, partial, paid, overdue, void, etc.).

`isDraft` boolean

Whether the document is still a draft.

`approved` boolean

Whether the document has been approved.

`isSent` boolean

Whether the document has been emailed to the customer.

`paymentStatus` string

Raw payment status (unpaid, partial, paid, etc.).

`subtotal` number

Subtotal before tax.

`taxTotal` number

Total tax amount.

`total` number

Grand total including tax.

`amountDue` number

Outstanding balance.

`products` array

Products or services billed on this document.

`createdAt` datetime

ISO 8601 creation timestamp.

`updatedAt` datetime

ISO 8601 last update timestamp.

Example

```json
{
  "id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
  "invoiceNumber": "INV-1042",
  "invoiceType": "invoice",
  "customerUuid": "dfa3219e-6af8-4c53-997a-037534f63a35",
  "date": "2026-03-01",
  "dueDate": "2026-03-31",
  "currency": "USD",
  "status": "sent",
  "isDraft": false,
  "approved": true,
  "isSent": true,
  "paymentStatus": "unpaid",
  "subtotal": 1000,
  "taxTotal": 85,
  "total": 1085,
  "amountDue": 1085,
  "products": [
    {
      "productUuid": "aa11bb22-cc33-dd44-ee55-ff6677889900",
      "description": "Consulting services",
      "quantity": 10,
      "unitPrice": 100,
      "nonTaxable": false
    }
  ],
  "createdAt": "2026-03-01T09:00:00.000Z",
  "updatedAt": "2026-03-02T11:15:00.000Z"
}
```

Credit memos share these routes

Credit memos use the same endpoints with `invoiceType: "memo"`. See the Credit Memos API reference for memo-focused examples.

Non-draft edits are restricted

Updates to approved or sent invoices are field-specific. Many invalid changes return 400. Concurrent updates may fail with a lock error.

Three ways to send a file

JSON `attachments` entries take a public `url` (COUNT downloads and keeps a copy) or the file inline as `contentBase64` (up to 10 MB). The `/upload` routes take `multipart/form-data`. All three are held to the same per-file cap and file types, at most 10 files a request, and every file is virus-scanned before anything is saved. To read a file back without following a link, call the attachment's `/content` route, which returns it base64-encoded.

File links are signed per response

Any `documentUrl`, `receiptUrl`, `pdfUrl` or `bankStatementUrl` on COUNT storage comes back as a short-lived signed link, minted only after COUNT proves the file belongs to this workspace. Use it straight away and call again for a fresh one; do not store it. A file COUNT cannot prove is the workspace's comes back as `null`. A link you attached to an outside file is returned exactly as you sent it.

## Related

- [Credit Memos API](https://developers.getcount.com/practice-manager/reference/credit-memo)
- [Customers API](https://developers.getcount.com/practice-manager/reference/customers)
- [Products & Services API](https://developers.getcount.com/practice-manager/reference/products-and-services)
- [Transactions API](https://developers.getcount.com/practice-manager/reference/transactions)

## Endpoints

[GET List invoices `/firm-partners/workspace/invoices` Returns a paginated list of invoices, estimates, or credit memos.](https://developers.getcount.com/practice-manager/reference/invoices/list-invoices) [GET Get an invoice `/firm-partners/workspace/invoices/{uuid}` Retrieves a single invoice, estimate, or credit memo by its UUID.](https://developers.getcount.com/practice-manager/reference/invoices/get-invoice) [GET Get the next invoice number `/firm-partners/workspace/invoices/generate/number` Returns the number COUNT would assign to the next invoice, estimate, or credit memo.](https://developers.getcount.com/practice-manager/reference/invoices/get-next-invoice-number) [POST Create an invoice `/firm-partners/workspace/invoices` Creates an invoice, estimate, or credit memo (invoiceType: "memo").](https://developers.getcount.com/practice-manager/reference/invoices/create-invoice) [PATCH Update an invoice `/firm-partners/workspace/invoices/{uuid}` Updates an invoice. Edits to non-draft invoices are field-specific and may be rejected.](https://developers.getcount.com/practice-manager/reference/invoices/update-invoice) [PATCH Approve an invoice `/firm-partners/workspace/invoices/{uuid}/approve` Approves a draft invoice or credit memo.](https://developers.getcount.com/practice-manager/reference/invoices/approve-invoice) [POST Send an invoice `/firm-partners/workspace/invoices/{uuid}/send` Emails the invoice to the customer. Requires a non-draft invoice with a customer and products.](https://developers.getcount.com/practice-manager/reference/invoices/send-invoice) [GET Get the public link `/firm-partners/workspace/invoices/{uuid}/public-link` Returns a shareable public link for the invoice, creating the public token if needed.](https://developers.getcount.com/practice-manager/reference/invoices/get-invoice-public-link) [GET Get audit log `/firm-partners/workspace/invoices/{uuid}/audit-log` Returns the audit history for an invoice, estimate, or credit memo.](https://developers.getcount.com/practice-manager/reference/invoices/get-invoice-audit-log) [GET Get send history `/firm-partners/workspace/invoices/{uuid}/send-history` Returns email send history and public-view analytics for an invoice, estimate, or credit memo.](https://developers.getcount.com/practice-manager/reference/invoices/get-invoice-send-history) [GET List invoice attachments `/firm-partners/workspace/invoices/{uuid}/attachments` Lists the files attached to an invoice, estimate or credit memo.](https://developers.getcount.com/practice-manager/reference/invoices/list-invoice-attachments) [POST Add attachments `/firm-partners/workspace/invoices/{uuid}/attachments` Attaches files to an invoice from public URLs or inline base64 content.](https://developers.getcount.com/practice-manager/reference/invoices/add-invoice-attachments) [POST Upload attachment `/firm-partners/workspace/invoices/{uuid}/attachments/upload` Uploads one file attachment via multipart form data.](https://developers.getcount.com/practice-manager/reference/invoices/upload-invoice-attachment) [PATCH Rename invoice attachment `/firm-partners/workspace/invoices/{uuid}/attachments/{attachmentUuid}` Changes the display title of one invoice attachment.](https://developers.getcount.com/practice-manager/reference/invoices/update-invoice-attachment) [DELETE Delete invoice attachment `/firm-partners/workspace/invoices/{uuid}/attachments/{attachmentUuid}` Removes one file from an invoice.](https://developers.getcount.com/practice-manager/reference/invoices/delete-invoice-attachment) [GET Get invoice attachment content `/firm-partners/workspace/invoices/{uuid}/attachments/{attachmentUuid}/content` Returns one invoice attachment's file, base64-encoded.](https://developers.getcount.com/practice-manager/reference/invoices/get-invoice-attachment-content) [PATCH Apply multiple credits to invoice `/firm-partners/workspace/invoices/{uuid}/apply-multiple-credit-to-invoice` Applies one or more credit memos to the target invoice.](https://developers.getcount.com/practice-manager/reference/invoices/apply-multiple-credit-to-invoice) [PATCH Apply credit to multiple invoices `/firm-partners/workspace/invoices/{uuid}/apply-credit-to-multiple-invoices` Applies a credit memo to one or more target invoices.](https://developers.getcount.com/practice-manager/reference/invoices/apply-credit-to-multiple-invoices) [PATCH Remove credit `/firm-partners/workspace/invoices/{uuid}/remove-credit` Unapplies a credit memo from an invoice.](https://developers.getcount.com/practice-manager/reference/invoices/remove-invoice-credit) [PATCH Add payment transactions `/firm-partners/workspace/invoices/{uuid}/add-transactions` Settles whole transactions against an invoice, or records a refund paid out on a credit memo.](https://developers.getcount.com/practice-manager/reference/invoices/add-invoice-transactions) [PATCH Remove transaction `/firm-partners/workspace/invoices/{uuid}/remove-transaction` Unassigns a payment transaction from an invoice.](https://developers.getcount.com/practice-manager/reference/invoices/remove-invoice-transaction) [DELETE Delete an invoice `/firm-partners/workspace/invoices/{uuid}` Deletes an invoice, estimate, or credit memo.](https://developers.getcount.com/practice-manager/reference/invoices/delete-invoice)
