---
title: "Retrieve Multi-Currency Pricing Rate by Id."
method: GET
path: "/multi-currency-pricing-rates/{multi-currency-pricing-rate-lookup-id}"
tags: ["Multi-Currency Pricing Rate Lookup"]
---

# Retrieve Multi-Currency Pricing Rate by Id.

`GET /multi-currency-pricing-rates/{multi-currency-pricing-rate-lookup-id}`

Retrieve Multi-Currency Pricing Rate results by Id.

## Response `200`

Multi-Currency Pricing (MCP) Rate lookup Response

- MultiCurrencyPricingRateLookup
  - `multiCurrencyPricingRateLookupId` string, required — Used to identify API resources which may be required for future follow-on transactions; i.e. Refunds, Corrections, Completions, Reversals, etc.
  - `multiCurrencyPricingTransactionType` 'PAYMENT' | 'REFUND', required — Value representing the type of subsequent transaction request that the rate token will be used for
  - `rateValidityEndTime` string, date-time, required — Date & Time
  - `rateConversions` MultiCurrencyPricingRateConversion[], required
    - `cardholderAmount` Money, required — Monetary amount. Note: The value must be in cents. Therefore $10.59 must be sent as 1059.
      - `amount` integer, required — Amount
      - `currency` string, iso-4217, required — Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO_4217
    - `merchantSettlementAmount` object, required — The amount that will be paid to the merchant, in settlement currency
      - `amount` integer, required — Amount
      - `currency` string, iso-4217, required — Provides the three letter currency code according the ISO 4217 standard. For a complete list of currency codes, visit: https://en.wikipedia.org/wiki/ISO_4217
    - `multiCurrencyPricingExchangeRate` number, required — The foreign exchange rate (foreign currency to CAD) that will be used for the transaction
    - `multiCurrencyPricingStatusCode` integer, required — HTTP Status code of the MCP transaction
    - `multiCurrencyPricingStatusMessage` string, required — Message corresponding to the MCP Status Code
  - `customData` object, nullable — Merchant can send custom meta data with the transaction in this object. Moneris will echo these values back in response.
  - `createdAt` string, date-time, required — Time at which the object was created

## Other responses

- `400` — Bad Request.
- `401` — Not authorized. The user does not have a valid API Key or Access Token.
- `403` — Forbidden. The user does not have permission to access the requested resource.
- `429` — Too Many Requests
- `500` — Unexpected error.
- `503` — Service Temporarily Unavailable

---

[API](https://skmtc.net/moneris/apis/moneris-api.md) · [All operations](https://skmtc.net/moneris/apis/moneris-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneris/moneris-api/revisions/edefcc925b74/schema)
