v45

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-2684278289.5 KB

Invoices

Update an invoice

Update an existing invoice

post/ar/invoices/{invoiceId}

Path parameters

invoiceIdstring uuid required

ID for the invoice.

Request body

achDebitEnabledboolean required

Whether or not the invoice can be paid via ACH debit.

ccEmailsEmail[] required

List of emails to be CCed on notifications/reminders.

creditCardEnabledboolean required

Whether or not the invoice can be paid via credit card. Requires Stripe to be setup for the Mercury account.

dueDatestring date required

The date the invoice should be paid by. YYYY-MM-DD

internalNotestring nullable

Internal note for the invoice, visible by users in the organization but not visible to payers.

invoiceDatestring date required

The date of the invoice, set by the invoice creator. Does not have to be the day the invoice was created. It can be business specific i.e. service/sale date. YYYY-MM-DD

invoiceNumberstring required

The invoice number.

payerMemostring nullable

Memo for the payer of the invoice.

poNumberstring nullable

The purchase order number for the invoice if applicable.

servicePeriodEndDatestring date nullable

The end date for the service period this invoice covers, if applicable. YYYY-MM-DD

servicePeriodStartDatestring date nullable

The start date for the service period this invoice covers, if applicable. YYYY-MM-DD

useRealAccountNumberboolean required

Whether or not the invoice payment instructions will show the real account and routing number for the destination account or use virtual account numbers instead.

Example request

{
  "dueDate": "2016-07-22",
  "invoiceDate": "2016-07-22",
  "servicePeriodEndDate": "2016-07-22",
  "servicePeriodStartDate": "2016-07-22"
}

Response

achDebitEnabledboolean required

Whether or not the invoice can be paid via ach debit.

amountnumber required

The total amount of the invoice line items plus taxes.

canceledAtstring yyyy-mm-ddThh:MM:ssZ nullable

The time when the invoice was canceled.

ccEmailsEmail[] required

Emails to be CCed on invoice notifications/reminders.

createdAtstring yyyy-mm-ddThh:MM:ssZ required

The timestamp when the invoice was created.

creditCardEnabledboolean required

Whether or not the invoice can be paid via credit card. Requires stripe to be setup for the Mercury account.

currencyCodestring required

ISO 4217 currency code for the invoice (e.g. "USD", "EUR").

customerIdstring uuid required

Id of the customer the invoice was sent to.

destinationAccountIdstring uuid required

The Mercury account where invoice payments will be deposited. Use the /api/v1/accounts endpoint to list your accounts and find the corresponding id. Only checking and savings accounts are supported.

dueDatestring date required

The due date the invoice should be paid by.

idstring uuid required

The ID of the invoice.

internalNotestring nullable

Internal note for the invoice, visible by users in the mercury organization but not visible to payers.

invoiceDatestring date required

The date of the invoice, set by the invoice creator and likely to be context specific to the type of transaction. i.e. it could be a date a service was performed, it does not need to be the date the invoice was created.

invoiceNumberstring required

The payer facing invoice number/identifier.

payerMemostring nullable

Memo for the payer of the invoice.

poNumberstring nullable

Purchase order number for the invoice if applicable.

servicePeriodEndDatestring date nullable

The end date for the service period this invoice covers, if applicable. YYYY-MM-DD

servicePeriodStartDatestring date nullable

The start date for the service period this invoice covers, if applicable. YYYY-MM-DD

slugstring required

Public slug for an invoice. Used to construct the pay page URL as well as the URL to retrieve the PDF of the invoice.

status'Unpaid' | 'Paid' | 'Cancelled' | 'Processing' required

The status of the invoice.

updatedAtstring yyyy-mm-ddThh:MM:ssZ required

The timestamp when the invoice was updated.

useRealAccountNumberboolean required

Whether or not the invoice payment instructions will show the real account and routing number for the destination account or use virtual account numbers instead.

Example response

{
  "canceledAt": "2016-07-22T00:00:00Z",
  "createdAt": "2016-07-22T00:00:00Z",
  "dueDate": "2016-07-22",
  "invoiceDate": "2016-07-22",
  "servicePeriodEndDate": "2016-07-22",
  "servicePeriodStartDate": "2016-07-22",
  "updatedAt": "2016-07-22T00:00:00Z"
}