> ## Documentation Index > Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt > Use this file to discover all available pages before exploring further. # The Invoice Object ## Attributes | Name | Type | Description | | - | - | - | | object | string | Value is “Invoice” | | id | string | A Subscribe-specified identifier for the invoice, aka Invoice Number. | | vid | string | A read-only Globally Unique Identifier (GUID) for this object. This field is created by Subscribe. | | invoice\_date | datetime | The billing date of the invoice. Typically the 1st day of the billed service period. This is the day when the invoice status goes from Open to Due. | | due\_date | datetime | The due date of the invoice. Typically the same as the “invoice date” unless Net Terms are specified for the Subscription. | | billing\_service\_period\_start | datetime | Start of the billing/service period covered by this invoice. | | billing\_service\_period\_end | datetime | End of the billing/service period covered by this invoice. | | status | enum | The status of the invoice. Values can be `Open`, `Due`, `Paid`, `Overdue`, `Closed`, `Written Off`. | | invoice\_currency | string | An ISO 4217 Currency Code. An invoice’s charges must be in a single currency. | | original\_invoice\_amount | decimal | The original net total of the invoice (in the currency identified as the invoice\_currency). | | invoice\_balance | decimal | The current balance due of the invoice (in the currency identified as the invoice\_currency). | | gross\_charges\_total | decimal | The original gross charges total of the invoice (in the currency identified as the invoice\_currency). Represents the pre-tax, pre-discount sub-total of all charge/purchase items. | | tax\_charges\_total | decimal | The original tax total of the invoice (in the currency identified as the invoice\_currency). | | credit\_total | decimal | The original discount and credit total of the invoice (in the currency identified as the invoice\_currency). | | payments\_received\_total | decimal | The current currency total of all payments successfully processed against this invoice. | | invoice\_line\_items | [Invoice Item](Invoice_Item) | The purchase or charge-based line items for the invoice. | | invoice\_tax\_items | [Invoice Item](Invoice_Item) | The tax-related line items for the invoice. | | invoice\_credit\_items | [Invoice Item](Invoice_Item) | The discount or credit line items for the invoice. | | invoice\_payments | [Transaction](Transactions) | Transactions which paid some or all of the invoice balance. | | account | [Account](Accounts) | The account invoiced. *Minified: includes id and vid only* | | subscription | [Subscription](Subscriptions) | The subscription for which this invoice bills. *Minified: includes id and vid only* | | billing\_sequence | integer | The subscription’s billing cycle for which this invoice charges. As a zero-based index, this indicates the renewal number. | | invoice\_terms | integer | Invoice terms from the owning [Subscription](Subscriptions). Represents Days after the invoice date at which a bill is considered delinquent, if the Subscription payment method is of type [Merchant Accepted Payment](Merchant_Accepted_Payment_Pay_By_Invoice). The value will be undefined for all other payment method types. | | affiliate | string | Affiliate or channel identifier, if any, under which the subscription was submitted. | | sub\_affiliate | string | A more granular or subordinate affiliate identifier. | | sales\_tax\_address | [Address](Addresses) | Subscribe-derived Address object provided to the Merchant's Tax Vendor for Invoice/Transaction tax calculation. This attribute will be null until the Invoice has become "Due" AND an Address object can be generated from either the Invoice's Account (shipping\_address) or PaymentMethod (billing\_address).**Note:** Read-only attribute | | metadata | hash | A set of key/value pairs that you can attach to an object. Useful for storing additional information. Invoice metadata is be inherited from the associated [Subscription's](Subscriptions) **metadata**. For more details, see [Metadata](Metadata). | ``` ``` ## Example Object ``` { "object": "Invoice", "id": "sub_1234-00000004", "invoice_date": "2020-06-16T00:00:00-07:00", "due_date": "2020-06-16T00:00:00-07:00", "billing_service_period_start": "2020-06-16T00:00:00-07:00", "billing_service_period_end": "2020-07-15T23:59:59-07:00", "status": "Paid", "invoice_currency": "USD", "original_invoice_amount": 15, "invoice_balance": 0, "gross_charges_total": 15, "tax_charges_total": 0, "credit_total": 0, "payments_received_total": 15, "invoice_line_items": { "object": "List", "data": [ { "object": "InvoiceItem", "index_number": 0, "type": "RecurringCharge", "sku": "prod_1234", "description": "Product 1", "quantity": 1, "unit_amount": 0, "tax_classification": "TaxExempt", "item_added": "2020-06-16T00:00:00-07:00", "item_removed": null }, { "object": "InvoiceItem", "index_number": 1, "type": "RecurringCharge", "sku": "prod_1235", "description": "Product 2", "quantity": 1, "unit_amount": 5, "tax_classification": "TaxExempt", "item_added": "2020-06-16T13:56:35-07:00", "item_removed": null }, { "object": "InvoiceItem", "index_number": 2, "type": "RecurringCharge", "sku": "bZ3oRYFwBNcx7sNtZGCZQBGS1XY", "description": "Test Product Description", "quantity": 1, "unit_amount": 10, "tax_classification": "TaxExempt", "item_added": "2020-06-16T13:56:35-07:00", "item_removed": null } ], "total_count": 3 }, "invoice_tax_items": { "object": "List", "data": [ { "object": "InvoiceItem", "index_number": 3, "type": "Tax", "sku": "VIN_SALES_TAX", "description": "Sales Tax Total", "quantity": 1, "unit_amount": 0, "tax_classification": "TaxExempt", "item_added": "2020-06-16T13:56:35-07:00", "item_removed": null } ], "total_count": 1 }, "invoice_payments": { "object": "List", "data": [ {...transaction...} ], "total_count": 1 }, "account": { "object": "Account", "id": "cust_1234", "vid": "11b9b85935256c8b0a1351298ec9c7b88047061a" }, "subscription": { "object": "Subscription", "id": "sub_1234", "vid": "566baf52d8add85a7c796e16a7b542fc3eecf583" }, "billing_sequence": 5, "invoice_terms": null, "affiliate": null, "sub_affiliate": null, "metadata": { "from_subscription": "1084518" } } ``` **Parent topic:**[Invoices](../topics/Invoices) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.