---
title: "Get Conversion Rate"
method: POST
path: "/currency-conversion"
---

# Get Conversion Rate

`POST /currency-conversion`

## Request body

- object
  - `account_id` string, required — The unique identifier of the account. You find this information on the [Yuno dashboard](https://dashboard.y.uno) (UUID; 36 chars).
  - `amount` object, required — Amount to be converted
    - `value` number, required — Amount to convert (must be equal or greater than 0).
    - `currency` string, required — The currency used to make the payment ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217); 3 chars).
    - `currency_conversion` object — Information to make the conversion
      - `cardholder_currency` string, required — The currency to make the conversion ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217); 3 chars).
  - `provider_data` object, required — Provider information
    - `id` 'CIBC' | 'MERCADO_PAGO', required — Identification of the provider
  - `payment_method` object — Payment method information. Provide either `token`, `vaulted_token`, or `card`.
    - `token` string — Payment method token (UUID; 36 chars).
    - `vaulted_token` string — Vaulted payment method token (UUID; 36 chars).
    - `card` object — Card information required for the currency conversion. Only for PCI compliant merchants.
      - `card_data` object — Card data information
        - `number` string, required — Card number without separators. Available for PCI-certified merchants (MIN 8).
        - `expiration_month` integer, required — Card expiration month (01-12). Available for PCI-certified merchants (2 chars).
        - `expiration_year` integer, required — Card expiration year. Available for PCI-certified merchants (4 chars).
        - `holder_name` string, required — Cardholder full name. Available for PCI-certified merchants (MIN 3; MAX 26).

## Response `200`

200

- object
  - `id` string
  - `amount` object
    - `value` integer
    - `currency` string
    - `currency_conversion` object
      - `cardholder_currency` string
      - `cardholder_amount` number
      - `rate` number
      - `provider_data` object
        - `id` string
        - `transaction_id` string
        - `response_code` string
        - `response_message` string
        - `raw_response` object
          - `fxRateInquiryResponse` object
            - `localDate` integer
            - `localTime` integer
            - `merchantID` string
            - `rateEndTime` integer
            - `ratePreferenceCode` string
            - `rateStartTime` integer
            - `rateValidityPeriod` integer
            - `rates` object[]
              - …
            - `responseCode` string
            - `responseMessage` string
            - `sessionId` string
            - `terminalID` string
            - `traceNumber` integer
  - `expired_at` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)