<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "ExternalPurchaseServerAPI",
  "identifier" : "/documentation/ExternalPurchaseServerAPI/exchangeRate",
  "metadataVersion" : "0.1.0",
  "role" : "Type",
  "symbol" : {
    "kind" : "Type",
    "modules" : [
      "External Purchase Server API"
    ],
    "preciseIdentifier" : "data:external_purchase_server_api:exchangeRate"
  },
  "title" : "exchangeRate"
}
-->

# exchangeRate

A decimal value that is the exchange rate you use to convert the pricing currency to the reporting currency, when the two currencies differ.

```
double exchangeRate
```

## Discussion

Maximum length: 128.  The field must contain a number that can optionally be followed by a “.” and additional digits.

The `exchangeRate` field is required when the [`pricingCurrency`](/documentation/ExternalPurchaseServerAPI/pricingCurrency) and [`reportingCurrency`](/documentation/ExternalPurchaseServerAPI/reportingCurrency) fields differ. Use the `exchangeRate` to convert amounts in the pricing currency to amounts in the reporting currency. The conversion calculation is:

`(amount in pricing currency) * exchangeRate = (amount in reporting currency)`

> Important: To determine an exchange rate for your calculations, use the Bloomberg exchange rate from within 48 hours of the transaction date.

If the [`pricingCurrency`](/documentation/ExternalPurchaseServerAPI/pricingCurrency) and [`reportingCurrency`](/documentation/ExternalPurchaseServerAPI/reportingCurrency) field values are the same currency, don’t include an `exchangeRate` in the line item.
For more information about determining which reporting currency to use, see [`reportingCurrency`](/documentation/ExternalPurchaseServerAPI/reportingCurrency).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)