# incentiveAmount

Describes the amount that can be redeemed from this incentive.

[QuantitativeValue](https://schema.org.ai/QuantitativeValue): Use this for incentives based on price (either raw amount or percentage-based). For a raw amount example, "You can claim $2,500 - $7,500 from the total cost of installation" would be represented as the following:

{ "@type": "QuantitativeValue", “minValue”: 2500, “maxValue”: 7500, "unitCode": "USD" }

[QuantitativeValue](https://schema.org.ai/QuantitativeValue) can also be used for percentage amounts. In such cases, value is used to represent the incentive’s percentage, while maxValue represents a limit (if one exists) to that incentive. The unitCode should be 'P1' and the unitText should be '%', while valueReference should be used for holding the currency type. For example, "You can claim up to 30% of the total cost of installation, up to a maximum of $7,500" would be:

{ "@type": "QuantitativeValue", "value": 30, "unitCode": "P1", "unitText": "%", “maxValue”: 7500, “valueReference”: “USD” }

[UnitPriceSpecification](https://schema.org.ai/UnitPriceSpecification): Use this for incentives that are based on amounts rather than price. For example, a net metering rebate that pays $10/kWh, up to $1,000:

{ "@type": "UnitPriceSpecification", "price": 10, "priceCurrency": "USD", "referenceQuantity": 1, "unitCode": "DO3", "unitText": "kw/h", "maxPrice": 1000, "description": "$10 / kwh up to $1000" }

[LoanOrCredit](https://schema.org.ai/LoanOrCredit): Use for incentives that are loan based. For example, a loan of $4,000 - $50,000 with a repayment term of 10 years, interest free would look like:

{ "@type": "LoanOrCredit", "loanTerm": { "@type":"QuantitativeValue", "value":"10", "unitCode": "ANN" }, "amount":\[ { "@type": "QuantitativeValue", "Name":"fixed interest rate", "value":"0", }, \], "amount":\[ { "@type": "MonetaryAmount", "Name":"min loan amount", "value":"4000", "currency":"CAD" }, { "@type": "MonetaryAmount", "Name":"max loan amount", "value":"50000", "currency":"CAD" } \], }

In summary:

* Use [QuantitativeValue](https://schema.org.ai/QuantitativeValue) for absolute/percentage-based incentives applied on the price of a good/service.

* Use [UnitPriceSpecification](https://schema.org.ai/UnitPriceSpecification) for incentives based on a per-unit basis (e.g. net metering).

* Use [LoanOrCredit](https://schema.org.ai/LoanOrCredit) for loans/credits.

.

## Expected Types

| Type | Description |
|------|-------------|
| [LoanOrCredit](https://schema.org.ai/LoanOrCredit) | A financial product for the loaning of an amount of money, or line of credit, under agreed terms and charges. |
| [QuantitativeValue](https://schema.org.ai/QuantitativeValue) | A point value or interval for product characteristics and other purposes. |
| [UnitPriceSpecification](https://schema.org.ai/UnitPriceSpecification) | The price asked for a given offer by the respective organization or person. |

## Used on Types

| Type | Description |
|------|-------------|
| [FinancialIncentive](https://schema.org.ai/FinancialIncentive) | Represents financial incentives for goods/services offered by an organization (or individual). Typically contains the [name](https://schema.org.ai/name) of the incentive, the [incentivizedItem](https://schema.org.ai/incentivizedItem), the [incentiveAmount](https://schema.org.ai/incentiveAmount), the [incentiveStatus](https://schema.org.ai/incentiveStatus), [incentiveType](https://schema.org.ai/incentiveType), the [provider](https://schema.org.ai/provider) of the incentive, and [eligibleWithSupplier](https://schema.org.ai/eligibleWithSupplier). Optionally contains criteria on whether the incentive is limited based on [purchaseType](https://schema.org.ai/purchaseType), [purchasePriceLimit](https://schema.org.ai/purchasePriceLimit), [incomeLimit](https://schema.org.ai/incomeLimit), and the [qualifiedExpense](https://schema.org.ai/qualifiedExpense). |

---

Quoted from Schema.org 30.1, https://schema.org/incentiveAmount, under CC BY-SA 3.0. Served by the Org.AI Foundation at https://schema.org.ai/incentiveAmount.
