Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| contact_id | string | Yes | Reference to the Contact who will be billed |
| currency_id | string | Yes | ISO 4217 currency code (e.g., USD, EUR) |
| document_number | string | No | Human-readable invoice number (auto-generated if not provided) |
| posted_date | string | No | Date when invoice is issued (ISO 8601). Defaults to current date |
| due_date | string | No | Payment due date (ISO 8601) |
| status | string | No | Invoice status (draft, open). Defaults to draft |
| line_items | array | Yes | Array of line item objects |
| memo | string | No | Additional notes for the invoice |
| subscription_id | string | No | Link to subscription (for recurring invoices) |
Line Item Fields
| Field | Type | Required | Description |
|---|---|---|---|
| item_id | string | No | Reference to an Item/Product |
| description | string | Yes | Description of the product or service |
| quantity | integer | Yes | Number of units |
| unit_amount | number | Yes | Price per unit |
| tax_amount | number | No | Tax for this line item |
| discount_amount | number | No | Discount applied |