Sign in

v1

latestOpenAPI 3.1.02026-07-261444991.2 MB
Invoice

Regenerate invoice PDF

This endpoint triggers a regeneration of the PDF for a finalized invoice.

The invoice must be finalized (issued, paid, synced, or void) and must already have an existing PDF. The original PDF is archived (not permanently deleted) to maintain an audit trail.

Important Legal Considerations:

Regenerating invoice PDFs may not be permitted in all jurisdictions. Many tax authorities require that issued invoices remain unmodified. Before using this endpoint, ensure that:

  • Your local tax regulations permit modification of issued billing documents
  • You have a legitimate business reason (e.g., fixing template errors, updating branding)
  • You maintain proper records of the original PDF (archived automatically by Orb)

Recommended use cases:

  • Correcting template rendering issues
  • Applying updated company branding
  • Updating customer data that was incorrect at issuance
post/invoices/{invoice_id}/regenerate_invoice_pdf

Path parameters

invoice_idstring required

Response

OK

metadataobject required

User specified key-value pairs for the resource. If not present, this defaults to an empty dictionary. Individual keys can be removed by setting the value to null, and the entire metadata mapping can be cleared by setting metadata to null.

voided_atstring date-time nullable required

If the invoice has a status of void, this gives a timestamp when the invoice was voided.

paid_atstring date-time nullable required

If the invoice has a status of paid, this gives a timestamp when the invoice was paid.

issued_atstring date-time nullable required

If the invoice has been issued, this will be the time it transitioned to issued (even if it is now in a different state.)

scheduled_issue_atstring date-time nullable required

If the invoice is in draft, this timestamp will reflect when the invoice is scheduled to be issued.

issue_failed_atstring date-time nullable required

If the invoice failed to issue, this will be the last time it failed to issue (even if it is now in a different state.)

sync_failed_atstring date-time nullable required

If the invoice failed to sync, this will be the last time an external invoicing provider sync was attempted. This field will always be null for invoices using Orb Invoicing.

payment_failed_atstring date-time nullable required

If payment was attempted on this invoice but failed, this will be the time of the most recent attempt.

payment_started_atstring date-time nullable required

If payment was attempted on this invoice, this will be the start time of the most recent attempt. This field is especially useful for delayed-notification payment mechanisms (like bank transfers), where payment can take 3 days or more.

amount_duestring required

This is the final amount required to be charged to the customer and reflects the application of the customer balance to the total of the invoice.

created_atstring date-time required

The creation time of the resource in Orb.

currencystring required

An ISO 4217 currency string or credits

due_datestring date-time nullable required

When the invoice payment is due. The due date is null if the invoice is not yet finalized.

idstring required
invoice_pdfstring nullable required

The link to download the PDF representation of the Invoice.

invoice_numberstring required

Automatically generated invoice number to help track and reconcile invoices. Invoice numbers have a prefix such as RFOBWG. These can be sequential per account or customer.

totalstring required

The total after any minimums and discounts have been applied.

status'issued' | 'paid' | 'synced' | 'void' | 'draft' required
invoice_source'subscription' | 'partial' | 'one_off' required
hosted_invoice_urlstring nullable required

A URL for the customer-facing invoice portal. This URL expires 60 days after the link is generated, or 30 days after the invoice's due date — whichever is later.

will_auto_issueboolean required

This is true if the invoice will be automatically issued in the future, and false otherwise.

eligible_to_issue_atstring date-time nullable required

If the invoice has a status of draft, this will be the time that the invoice will be eligible to be issued, otherwise it will be null. If auto-issue is true, the invoice will automatically begin issuing at this time.

memostring nullable required

Free-form text which is available on the invoice PDF and the Orb invoice portal.

{"stackTrail":"components:schemas:DEPRECATED_InvoiceLevelDiscount","oasType":"schema","type":"unknown","title":"DEPRECATED_InvoiceLevelDiscount"}
minimum_amountstring nullable required
maximum_amountstring nullable required
subtotalstring required

The total before any discounts and minimums are applied.

invoice_datestring date-time required

The scheduled date of the invoice