MonetaryAmount
A Schema.org Type
- Canonical URL: https://schema.org/MonetaryAmount
- Check for open issues.
A monetary value or range. This type can be used to describe an amount of money such as $50 USD, or a range as in describing a bank account being suitable for a balance between £1,000 and £1,000,000 GBP, or the value of a salary, etc. It is recommended to use PriceSpecification Types to describe the price of an Offer, Invoice, etc.
Property | Expected Type | Description |
---|---|---|
Properties from MonetaryAmount | ||
currency |
Text | The currency in which the monetary amount is expressed. Use standard formats: ISO 4217 currency format, e.g. "USD"; Ticker symbol for cryptocurrencies, e.g. "BTC"; well known names for Local Exchange Trading Systems (LETS) and other currency types, e.g. "Ithaca HOUR". |
maxValue |
Number | The upper value of some characteristic or property. |
minValue |
Number | The lower value of some characteristic or property. |
validFrom |
Date or DateTime |
The date when the item becomes valid. |
validThrough |
Date or DateTime |
The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours. |
value |
Boolean or Number or StructuredValue or Text |
The value of a QuantitativeValue (including Observation) or property value node.
|
Properties from Thing | ||
additionalType |
Text or URL |
An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide. |
alternateName |
Text | An alias for the item. |
description |
Text or TextObject |
A description of the item. |
disambiguatingDescription |
Text | A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation. |
identifier |
PropertyValue or Text or URL |
The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details. |
image |
ImageObject or URL |
An image of the item. This can be a URL or a fully described ImageObject. |
mainEntityOfPage |
CreativeWork or URL |
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
Inverse property: mainEntity |
name |
Text | The name of the item. |
potentialAction |
Action | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role. |
sameAs |
URL | URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website. |
subjectOf |
CreativeWork or Event |
A CreativeWork or Event about this Thing.
Inverse property: about |
url |
URL | URL of the item. |
Instances of
MonetaryAmount may appear as a value for the following properties
Property | On Types | Description |
---|---|---|
accountMinimumInflow | BankAccount | A minimum amount that has to be paid in every month. |
accountOverdraftLimit | BankAccount | An overdraft is an extension of credit from a lending institution when an account reaches zero. An overdraft allows the individual to continue withdrawing money even if the account has no funds in it. Basically the bank allows people to borrow a set amount of money. |
amount |
DatedMoneySpecification or InvestmentOrDeposit or LoanOrCredit or MonetaryGrant or MoneyTransfer |
The amount of money. |
baseSalary |
EmployeeRole or JobPosting |
The base salary of the job or of an employee in an EmployeeRole. |
customerRemorseReturnShippingFeesAmount | MerchantReturnPolicy | The amount of shipping costs if a product is returned due to customer remorse. Applicable when property customerRemorseReturnFees equals ReturnShippingFees. |
downPayment | RepaymentSpecification | a type of payment made in cash during the onset of the purchase of an expensive good/service. The payment typically represents only a percentage of the full purchase price. |
earlyPrepaymentPenalty | RepaymentSpecification | The amount to be paid as a penalty in the event of early payment of the loan. |
estimatedCost |
HowTo or HowToSupply |
The estimated cost of the supply or supplies consumed when performing instructions. |
estimatedSalary |
JobPosting or Occupation |
An estimated salary for a job posting or occupation, based on a variety of variables including, but not limited to industry, job title, and location. Estimated salaries are often computed by outside organizations rather than the hiring organization, who may not have committed to the estimated value. |
exchangeRateSpread | ExchangeRateSpecification | The difference between the price at which a broker or other intermediary buys and sells foreign currency. |
floorLimit | PaymentCard | A floor limit is the amount of money above which credit card transactions must be authorized. |
freeShippingThreshold | ShippingRateSettings | A monetary value above (or at) which the shipping rate becomes free. Intended to be used via an OfferShippingDetails with shippingSettingsLink matching this ShippingRateSettings. |
hasTierRequirement | MemberProgramTier | A requirement for a user to join a membership tier, for example: a CreditCard if the tier requires sign up for a credit card, A UnitPriceSpecification if the user is required to pay a (periodic) fee, or a MonetaryAmount if the user needs to spend a minimum amount to join the tier. If a tier is free to join then this property does not need to be specified. |
itemDefectReturnShippingFeesAmount | MerchantReturnPolicy | Amount of shipping costs for defect product returns. Applicable when property itemDefectReturnFees equals ReturnShippingFees. |
loanMortgageMandateAmount | MortgageLoan | Amount of mortgage mandate that can be converted into a proper mortgage at a later stage. |
loanPaymentAmount | RepaymentSpecification | The amount of money to pay in a single payment. |
minimumPaymentDue | Invoice | The minimum payment required at this time. |
monthlyMinimumRepaymentAmount | PaymentCard | The minimum payment is the lowest amount of money that one is required to pay on a credit card statement each month. |
netWorth | Person | The total financial value of the person as calculated by subtracting assets from liabilities. |
restockingFee |
MerchantReturnPolicy or MerchantReturnPolicySeasonalOverride |
Use MonetaryAmount to specify a fixed restocking fee for product returns, or use Number to specify a percentage of the product price paid by the customer. |
returnShippingFeesAmount |
MerchantReturnPolicy or MerchantReturnPolicySeasonalOverride |
Amount of shipping costs for product returns (for any reason). Applicable when property returnFees equals ReturnShippingFees. |
shippingRate |
OfferShippingDetails or ShippingRateSettings |
The shipping rate is the cost of shipping to the specified destination. Typically, the maxValue and currency values (of the MonetaryAmount) are most appropriate. |
totalPaymentDue | Invoice | The total amount due. |
Supersedes |
---|
DatedMoneySpecification |
Acknowledgements
Financial Industry Business Ontology project
Examples
Example 1
Copied
Example notes or example HTML without markup.
Wells Fargo Secured Visa® Credit Card Requires a minimum $300 security deposit. When you apply, you provide a minimum security deposit of at least $300, or up to $10,000. Annual fee $25 Annual Percentage Rate (APR) Currently, a variable 18.99% APR on purchases. (These APRs do not apply to cash advances.) <a href="https://www.wellsfargo.com/credit-cards/secured/terms/">Full terms and conditions</a>
Example encoded as Microdata embedded in HTML.
<div itemscope itemtype="https://schema.org/CreditCard"> <span itemprop="name">Wells Fargo Secured Visa® Credit Card</span> <span itemprop="requiredCollateral">Requires a minimum $300 security deposit.</span> <span itemprop="amount" itemscope itemtype="https://schema.org/MonetaryAmount">When you apply, you provide a minimum security deposit of at least <span itemprop="currency" content="USD">$</span> <span itemprop="minValue">300</span>, or up to $ <span itemprop="maxValue" content="10000">10,000</span>. </span> <span itemprop="offers" itemscope itemtype="https://schema.org/Offer"> <meta itemprop="offeredBy" content="Wells Fargo"/> <span itemprop="priceSpecification" itemscope itemtype="https://schema.org/UnitPriceSpecification">Annual fee <span itemprop="priceCurrency" content="USD">$</span> <span itemprop="price">25</span> <span itemprop="referenceQuantity" itemscope itemtype="https://schema.org/QuantitativeValue"> <meta itemprop="value" content="1"/><meta itemprop="unitCode" content="ANN"/> </span> </span> </span> <span>Annual Percentage Rate (APR) Currently, a variable <span itemprop="annualPercentageRate">18.99</span>% APR on purchases. (These APRs do not apply to cash advances.) </span> <a itemprop="feesAndCommissionsSpecification" href="https://www.wellsfargo.com/credit-cards/secured/terms/">Full terms and conditions</a> </div>
Example encoded as RDFa embedded in HTML.
<div vocab="https://schema.org/" typeof="CreditCard"> <span property="name">Wells Fargo Secured Visa® Credit Card</span> <span property="requiredCollateral">Requires a minimum $300 security deposit.</span> <span property="amount" typeof="MonetaryAmount">When you apply, you provide a minimum security deposit of at least <span property="currency" content="USD">$</span> <span property="minValue">300</span>, or up to $ <span property="maxValue" content="10000">10,000</span>. </span> <span property="offers" typeof="Offer"> <meta property="offeredBy" content="Wells Fargo"/> <span property="priceSpecification" typeof="UnitPriceSpecification">Annual fee <span property="priceCurrency" content="USD">$</span> <span property="price">25</span> <span property="referenceQuantity" typeof="QuantitativeValue"> <meta property="value" content="1"/> <meta property="unitCode" content="ANN"/> </span> </span> </span> <span>Annual Percentage Rate (APR) Currently, a variable <span property="annualPercentageRate">18.99</span>% APR on purchases. (These APRs do not apply to cash advances.) </span> <a property="feesAndCommissionsSpecification" href="https://www.wellsfargo.com/credit-cards/secured/terms/">Full terms and conditions</a> </div>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "CreditCard", "name": "Wells Fargo Secured Visa® Credit Card", "requiredCollateral": "Requires a minimum $300 security deposit.", "amount": { "@type": "MonetaryAmount", "minValue": "300", "maxValue": "10000", "currency": "USD" }, "offers": { "@type": "Offer", "offeredBy": { "@type": "BankOrCreditUnion", "name":"Wells Fargo" }, "priceSpecification": { "@type": "UnitPriceSpecification", "price": "25", "priceCurrency": "USD", "referenceQuantity": { "@type": "QuantitativeValue", "value": "1", "unitCode": "ANN" } } }, "annualPercentageRate": "18.99", "feesAndCommissionsSpecification": "https://www.wellsfargo.com/credit-cards/secured/terms/" } </script>
Structured representation of the JSON-LD example.
Example 2
Copied
Example notes or example HTML without markup.
<div> Wells Fargo GraduateSM Student Loan You'll have up to 15 years to repay the loan. Competitive Annual Percentage Rate (APR) Variable interest rates range from 3.22% APR (with discount) to 8.74% APR (without discount). Fixed interest rates range from 6.36% APR (with discount) to 10.61% APR (without discount). The lifetime limit for this loan combined with all other education-related debt is $180,000 for law and business, and $120,000 for other fields of study. </div>
Example encoded as Microdata embedded in HTML.
<!-- Wells Fargo GraduateSM Student Loan --> <div itemscope itemtype="https://schema.org/LoanOrCredit"> <span itemprop="name">Wells Fargo GraduateSM Student Loan</span> You'll have up to <div itemprop="loanTerm" itemscope itemtype="https://schema.org/QuantitativeValue"> <span itemprop="value" content="15">15</span> <span itemprop="unitCode" content="ANN">years</span> </div> to repay the loan. Competitive Annual Percentage Rate (APR) <div itemprop="annualPercentageRate" itemscope itemtype="https://schema.org/QuantitativeValue"> <span itemprop="name">Variable interest rates</span> range from <span itemprop="minValue" content="3.22">3.22%</span> APR (with discount) to <span itemprop="maxValue" content="8.74">8.74%</span> APR (without discount). </div> <div itemprop="annualPercentageRate" itemscope itemtype="https://schema.org/QuantitativeValue"> <span itemprop="name">Fixed interest rates</span> range from <span itemprop="minValue" content="6.36">6.36%</span> APR (with discount) to <span itemprop="maxValue" content="10.61">10.61%</span> APR (without discount). </div> The lifetime limit for this loan combined with all other education-related debt is <div itemprop="amount" itemscope itemtype="https://schema.org/MonetaryAmount"> <span itemprop="currency" content="USD">$</span> <span itemprop="value" content="180000">180,000</span> <span itemprop="name">for law and business</span>, </div> and <div itemprop="amount" itemscope itemtype="https://schema.org/MonetaryAmount"> <span itemprop="currency" content="USD">$</span> <span itemprop="value" content="120000">120,000</span> <span itemprop="name">for other fields of study</span>. </div> </div>
Example encoded as RDFa embedded in HTML.
<!-- Wells Fargo GraduateSM Student Loan --> <div vocab="https://schema.org/" typeof="LoanOrCredit"> <span property="name">Wells Fargo GraduateSM Student Loan</span> You'll have up to <div property="loanTerm" typeof="QuantitativeValue"> <span property="value" content="15">15</span> <span property="unitCode" content="ANN">years</span> </div> to repay the loan. Competitive Annual Percentage Rate (APR) <div property="annualPercentageRate" typeof="QuantitativeValue"> <span property="name">Variable interest rates</span> range from <span property="minValue" content="3.22">3.22%</span> APR (with discount) to <span property="maxValue" content="8.74">8.74%</span> APR (without discount). </div> <div property="annualPercentageRate" typeof="QuantitativeValue"> <span property="name">Fixed interest rates</span> range from <span property="minValue" content="6.36">6.36%</span> APR (with discount) to <span property="maxValue" content="10.61">10.61%</span> APR (without discount). </div> The lifetime limit for this loan combined with all other education-related debt is <div property="amount" typeof="MonetaryAmount"> <span property="currency" content="USD">$</span> <span property="value" content="180000">180,000</span> <span property="name">for law and business</span>, </div> and <div property="amount" typeof="MonetaryAmount"> <span property="currency" content="USD">$</span> <span property="value" content="120000">120,000</span> <span property="name">for other fields of study</span>. </div> </div>
Example encoded as JSON-LD in a HTML script tag.
<!-- Wells Fargo GraduateSM Student Loan --> <script type="application/ld+json"> { "@context":"https://schema.org", "@type":"LoanOrCredit", "name":"Wells Fargo GraduateSM Student Loan", "loanTerm":{ "@type":"QuantitativeValue", "value":"15", "unitCode": "ANN" }, "annualPercentageRate":[ { "@type":"QuantitativeValue", "name": "variable interest rates", "minValue":"3.22", "maxValue":"8.74" }, { "@type":"QuantitativeValue", "name": "fixed interest rates", "minValue":"6.36", "maxValue":"10.61" } ], "amount":[ { "@type": "MonetaryAmount", "name":"debt for law and business", "value":"180000", "currency":"USD" }, { "@type": "MonetaryAmount", "name":"debt for other fields of study than law and business", "value":"120000", "currency":"USD" } ] } </script>
Structured representation of the JSON-LD example.
Example 3
Copied
Example notes or example HTML without markup.
<body> <h1>Easy access accounts Comparison - Ordered by interest rate (AER)</h1> <div> <table> <tr> <th>Bank</th><th>Account</th><th>Interest Rate</th><th>Min/Max Opening Amount</th><th>Access</th> </tr> <tr> <td><a href="https://www.rcibank.co.uk">RCI Bank</a></td> <td>Freedom Savings Account</td> <td>1.65% Variable</td> <td>£100 to £1,000,000</td> <td>Internet, Post, Telephone</td> </tr> <tr> <td><a href="https://sbiukonlinesavings.com/">State Bank of India</a></td> <td>Online Instant Access Savings Issue 4</td> <td>1.25% Variable</td> <td>£500 to £1,000,000</td> <td>Internet, In Branch</td> </tr> <tr> <td><a href="http://www.aldermore.co.uk/">Aldermore</a></td> <td>Easy Access Issue 9</td> <td>1.25% Variable</td> <td>£1,000 to £1,000,000</td> <td>Internet, Post, Telephone</td> </tr> </table> </div> </body>
Example encoded as Microdata embedded in HTML.
<body itemscope itemtype="https://schema.org/WebPage"> <h1 itemprop="name">Easy access accounts Comparison - Ordered by interest rate (AER)</h1> <div itemprop="mainEntity" itemscope itemtype="https://schema.org/ItemList"> <meta itemprop="name" content="Easy access accounts Comparison List"/> <table> <tr> <th>Bank</th><th>Account</th><th>Interest Rate</th><th>Min/Max Opening Amount</th><th>Access</th> </tr> <tr itemprop="itemListElement" itemscope itemtype="https://schema.org/DepositAccount"> <td><a itemprop="provider" href="https://www.rcibank.co.uk">RCI Bank</a></td> <td itemprop="name">Freedom Savings Account</td> <td itemprop="interestRate" itemscope itemtype="https://schema.org/QuantitativeValue"><span itemprop="value">1.65</span>% <span itemprop="valueReference">Variable</span></td> <td itemprop="amount" itemscope itemtype="https://schema.org/MonetaryAmount"><meta itemprop="currency" content="GBP"/>£<span itemprop="minValue" content="100">100</span> to £<span itemprop="maxValue" content="1000000">1,000,000</span></td> <td><span itemprop="availableChannel">Internet</span>, <span itemprop="availableChannel">Post</span>, <span itemprop="availableChannel">Telephone</span></td> </tr> <tr itemprop="itemListElement" itemscope itemtype="https://schema.org/DepositAccount"> <td><a itemprop="provider" href="https://sbiukonlinesavings.com/">State Bank of India</a></td> <td itemprop="name">Online Instant Access Savings Issue 4</td> <td itemprop="interestRate" itemscope itemtype="https://schema.org/QuantitativeValue"><span itemprop="value">1.25</span>% <span itemprop="valueReference">Variable</span></td> <td itemprop="amount" itemscope itemtype="https://schema.org/MonetaryAmount"><meta itemprop="currency" content="GBP"/>£<span itemprop="minValue" content="500">500</span> to £<span itemprop="maxValue" content="1000000">1,000,000</span></td> <td><span itemprop="availableChannel">Internet</span>, <span itemprop="availableChannel">In Branch</span></td> </tr> <tr itemprop="itemListElement" itemscope itemtype="https://schema.org/DepositAccount"> <td><a itemprop="provider" href="http://www.aldermore.co.uk/">Aldermore</a></td> <td itemprop="name">Easy Access Issue 9</td> <td itemprop="interestRate" itemscope itemtype="https://schema.org/QuantitativeValue"><span itemprop="value">1.25</span>% <span itemprop="valueReference">Variable</span></td> <td itemprop="amount" itemscope itemtype="https://schema.org/MonetaryAmount"><meta itemprop="currency" content="GBP"/>£<span itemprop="minValue" content="1000">1,000</span> to £<span itemprop="maxValue" content="1000000">1,000,000</span></td> <td><span itemprop="availableChannel">Internet</span>, <span itemprop="availableChannel">Post</span>, <span itemprop="availableChannel">Telephone</span></td> </tr> </table> </div> </body>
Example encoded as RDFa embedded in HTML.
<body vocab="https://schema.org/" typeof="WebPage"> <h1 property="name">Easy access accounts Comparison - Ordered by interest rate (AER)</h1> <div property="mainEntity" typeof="ItemList"> <meta property="name" content="Easy access accounts Comparison List"/> <table> <tr> <th>Bank</th><th>Account</th><th>Interest Rate</th><th>Min/Max Opening Amount</th><th>Access</th> </tr> <tr property="itemListElement" typeof="DepositAccount"> <td><a property="provider" href="https://www.rcibank.co.uk">RCI Bank</a></td> <td property="name">Freedom Savings Account</td> <td property="interestRate" typeof="QuantitativeValue"><span property="value">1.65</span>% <span property="valueReference">Variable</span></td> <td property="amount" typeof="MonetaryAmount"><meta property="currency" content="GBP"/>£<span property="minValue" content="100">100</span> to £<span property="maxValue" content="1000000">1,000,000</span></td> <td><span property="availableChannel">Internet</span>, <span property="availableChannel">Post</span>, <span property="availableChannel">Telephone</span></td> </tr> <tr property="itemListElement" typeof="DepositAccount"> <td><a property="provider" href="https://sbiukonlinesavings.com/">State Bank of India</a></td> <td property="name">Online Instant Access Savings Issue 4</td> <td property="interestRate" typeof="QuantitativeValue"><span property="value">1.25</span>% <span property="valueReference">Variable</span></td> <td property="amount" typeof="MonetaryAmount"><meta property="currency" content="GBP"/>£<span property="minValue" content="500">500</span> to £<span property="maxValue" content="1000000">1,000,000</span></td> <td><span property="availableChannel">Internet</span>, <span property="availableChannel">In Branch</span></td> </tr> <tr property="itemListElement" typeof="DepositAccount"> <td><a property="provider" href="http://www.aldermore.co.uk/">Aldermore</a></td> <td property="name">Easy Access Issue 9</td> <td property="interestRate" typeof="QuantitativeValue"><span property="value">1.25</span>% <span property="valueReference">Variable</span></td> <td property="amount" typeof="MonetaryAmount"><meta property="currency" content="GBP"/>£<span property="minValue" content="1000">1,000</span> to £<span property="maxValue" content="1000000">1,000,000</span></td> <td><span property="availableChannel">Internet</span>, <span property="availableChannel">Post</span>, <span property="availableChannel">Telephone</span></td> </tr> </table> </div> </body>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebPage", "name": "Easy access accounts Comparison - Ordered by interest rate (AER)", "mainEntity": { "@type": "ItemList", "name": "Easy access accounts Comparison List", "itemListElement": [ { "@type": "DepositAccount", "provider": { "@id": "https://www.rcibank.co.uk", "name": "RCI Bank" }, "name": "Freedom Savings Account", "interestRate": { "@type": "QuantitativeValue", "value": "1.65", "valueReference": "Variable" }, "amount": { "@type": "MonetaryAmount", "currency": "GBP", "minValue": "100", "maxValue": "1000000" }, "availableChannel": ["Internet","Post","Telephone"] }, { "@type": "DepositAccount", "provider": { "@id": "https://sbiukonlinesavings.com/", "name": "State Bank of India" }, "name": "Online Instant Access Savings Issue 4", "interestRate": { "@type": "QuantitativeValue", "value": "1.25", "valueReference": "Variable" }, "amount": { "@type": "MonetaryAmount", "currency": "GBP", "minValue": "500", "maxValue": "1000000" }, "availableChannel": ["Internet","In Branch"] }, { "@type": "DepositAccount", "provider": { "@id": "http://www.aldermore.co.uk/", "name": "Aldermore" }, "name": "Easy Access Issue 9", "interestRate": { "@type": "QuantitativeValue", "value": "1.65", "valueReference": "Variable" }, "amount": { "@type": "MonetaryAmount", "currency": "GBP", "minValue": "1000", "maxValue": "1000000" }, "availableChannel": ["Internet","Post","Telephone"] } ] } } </script>
Structured representation of the JSON-LD example.