title: Monetary Values
source_url: /developer-api/v1/monetary-values
summary: In the Ramp API, monetary values are represented by the currency_code and amount. All currency_code values are three-letter acronyms as defined in ISO 4217 (e.g., USD for US Dollars). There are two representations of the amount:

content:
In the Ramp API, monetary values are represented by the currency_code and amount. All currency_code values are three-letter acronyms as defined in ISO 4217 (e.g., USD for US Dollars). There are two representations of the amount:

Canonical representation (Preferred)

Ramp's preferred method for representing monetary values is canonical representation, which uses the CurrencyAmount type to group amount and currency_code together. The amount is represented as an integer in the smallest denomination to avoid precision loss.

For example:

USD: $40 is represented as 4000 (since 1 USD = 100 cents)

JPY: ¥5000 is represented as 5000 (since 1 JPY = 1 yen)

To calculate the correct amount for different currencies, the canonical representation multiplies the amount by 10 raised to the power of D, where D is the number of decimal places for the currency. You can find the D value for any currency in the ISO 4217 Wikipedia page.

USD, EUR, GBP, etc.: D = 2 (i.e., multiply the amount by 100 for cents)

JPY: D = 0 (i.e., no decimal places)

Formula:

For example, for USD:

USD

4000 ($40.00)

2

EUR

10000 (€100.00)

JPY

5000 (¥5000)

0

GBP

2500 (£25.00)

Below is the schema definition of CurrencyAmount type:

The legacy representation is an older way of representing amounts. Although this method is still supported for backward compatibility, it is deprecated and will be replaced in future releases. You should migrate to the canonical representation for new development.

Date and DateTime are represented using a string that conforms to ISO8601; UTC is assumed if no timezone offset is specified. For example,