---
title: "Invoice data model"
url: "https://docs.unified.to/accounting/invoice/model"
description: "API reference for Invoice data model. Launch multiple pre-built Invoice integrations today with zero maintenance — all through a single API."
generated_at: "2026-05-25T17:20:50.636Z"
---
# Invoice data model

 View field support, webhooks, and list parameters for each integration on the [Supported Integrations](/accounting/integrations) page. 

### 

* Data Model
* Typescript Type
* Zod Shape
* Python Class

Data Model

**id**string 

**created\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**updated\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**due\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**paid\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**refunded\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**cancelled\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**posted\_at**date 

(ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)

**total\_amount**number 

**paid\_amount**number 

**refund\_amount**number 

**tax\_amount**number 

**discount\_amount**number 

**balance\_amount**number 

**invoice\_number**string 

External identifier (ie. reference) for this invoice

**reference**string 

**contact\_id**string 

(reference to AccountingContact)

**currency**string 

**notes**string 

**refund\_reason**string 

**lineitems** array 

**status** enum

Valid values:

 "DRAFT" 

 "VOIDED" 

 "AUTHORIZED" 

 "PAID" 

 "PARTIALLY\_PAID" 

**url**string 

The public URL for the invoice to send to a customer to view or pay.

**payment\_collection\_method** enum

Valid values:

 "send\_invoice" 

 "charge\_automatically" 

When set to charging\_automatically, an automated attempt will occur to pay this invoice using the default payment source attached to the contactcustomer. When set to send\_invoice, an will email will be sent with this invoice to the contact/customer with payment instructions.

**type** enum

Valid values:

 "BILL" 

 "INVOICE" 

 "CREDITMEMO" 

@deprecated; for bills, use AccountingBill instead

**attachments** array 

**send**boolean 

**organization\_id**string 

**raw**any