---
title: "Partially update an invoice"
method: PATCH
path: "/api/invoices/{invoiceId}"
tags: ["Invoice"]
---

# Partially update an invoice

`PATCH /api/invoices/{invoiceId}`

## Path parameters

- `invoiceId` string, required

## Response `200`

Invoice item

- InvoiceDto — Represents an invoice
  - `id` string, required — Unique id associated to this entity.
  - `number` integer, required — Number
  - `status` 'new' | 'needsApproval' | 'approved' | 'issued' | 'paid', required — Invoice status
  - `customerId` string, required — The id of the customer that the invoice is for. Please reference /api/customers endpoint.
  - `currencyInfo` CurrencyInfoDto — Currency Info Dto
    - `documentCurrencyCode` string, required — Document Currency Code
    - `primaryCurrencyCode` string, required — Primary Currency Code
  - `issueDate` string, date-time, nullable — Invoice issued date indicates when the invoice was sent to the customer.
  - `externalReferences` object, nullable — External references associated with this entity.
  - `paymentTermsId` string, nullable — Payment terms key identifier. Please reference /api/payment-terms endpoint.
  - `paymentTerms` CommonReferenceDto — Represents a reference to a document in a DB collection
    - `id` string, nullable — Unique Id associated to the referenced object
    - `name` string, nullable — Descriptive name associated to the object
  - `companyInfoId` string, nullable — Company Information Id;
  - `salesOrderId` string, nullable — Sales order identifier. Please reference /api/sales-orders endpoint.
  - `customerPONumber` string, nullable — Customer PO number.
  - `dueDate` string, date-time, nullable — Invoice due date.
  - `total` number, double, required — The final amount due, calculated as the sum of all item costs, taxes, fees, and any discounts applied in primary currency.
  - `subtotal` number, double, required — The sum of all item costs before taxes and discounts are applied in primary currency.
  - `lineItemsTotal` number, double — The summation of the line item amounts due.
  - `notesToCustomer` string, nullable — A field for the seller to provide additional details or instructions for the customer relating to the order.
  - `billingAddress` CommonAddressDto — Address definition
    - `name` string, nullable — Name of the address (Bob's Shipping, Primary, Reno Warehouse, etc).
    - `address1` string, required — Primary address line.
    - `address2` string, nullable — Second address line.
    - `address3` string, nullable — Third address line.
    - `city` string, required — Address city
    - `stateProvince` string, nullable — Address state/province.
    - `postalCode` string, required — Postal/zip code.
    - `country` string, nullable — Country identifier.
    - `phone` string, tel, nullable — Phone number.
    - `email` string, email, nullable — Email address
  - `customFields` object, nullable — Custom fields that have been defined on this entity.
  - `isDeposit` boolean — Is deposit invoice
  - `deleted` boolean — Indicates whether this invoice has been deleted

## Other responses

- `404` — Invoice did not exist

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)