# Quote

Quotes provide a preview of the invoices, including taxes and fees, that will occur when creating a subscription or add-on.

## Properties

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `object` | string | Yes | Type of object is always `quote`. |
| `id` | string | Yes | Unique identifier for the quote. |
| `address` | string,null | Yes | The unique identifier for the address that the taxes were quoted for. Present when quoting local plans. |
| `createdAt` | string | Yes | Time when the quote was created. |
| `discount` | object | Yes | The total discount applied. This is the sum of the discounts of each line item. |
| `expiredAt` | string | Yes | The timestamp indicating when the quote expires. Set to 2 hours after the quote's creation time. |
| `fees` | object[] | Yes | The fees for the quote. |
| `lineItems` | object[] | Yes | The line items that make up the quote. |
| `reason` | other | subscriptionChange | subscriptionCreation | Yes | The reason this quote was created. It can have one of the following values:    - `subscriptionCreation`: The quote is for a new subscription.   - `subscriptionChange`: The quote is for a subscription change (e.g. plan upgrade).   - `other`: The quote is not related to a subscription but due an e.g. one-time addon.  |
| `subtotal` | object | Yes | The total amount before any discounts, taxes or fees are applied. |
| `tax` | object | Yes | The total amount of taxes. This is the sum of the taxes of each line item. |
| `taxExemptionReason` | null | calculationFailed | fullyDiscounted | inclusiveTaxExceedsPrice | userExempted | Yes | The reason for the taxes not being calculated, if any. It can have one of the following values:    - `calculationFailed`: The tax calculation failed for an unspecified reason.   - `inclusiveTaxExceedsPrice`: The calculated tax is too large to be included in the price.   - `fullyDiscounted`: The quote is fully discounted due to a voucher or a free product.   - `userExempted`: The user is marked as exempted from taxes.  |
| `total` | object | Yes | The total amount after all discounts, taxes and fees are applied. |
| `user` | string | Yes | The unique identifier for the user that this quote belongs to. |
| `voucher` | string,null | Yes | The unique identifier for the voucher applied to the quote, if any. |