Currency Conversion

Convert currency using flat rates

Convert currency using FX rates used in Remote’s estimation tools. These rates are not guaranteed to match final onboarding or contract rates.

Authentication

This endpoint accepts any one of the following token types:

  • Company-scoped access token (OAuth2AuthorizationCode) — obtained through the Authorization Code flow or the Refresh Token flow, acting as the user who authorized it. See Authentication for partners.
  • Company-scoped access token (assertion) (OAuth2CompanyManagerAssertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant for a company manager. See OAuth Assertion.
  • Client credentials access token (OAuth2ClientCredentials) — obtained through the Client Credentials flow or the Refresh Token flow. See Authentication for partners.
  • Employee-scoped access token (OAuth2Assertion) — obtained through the urn:ietf:params:oauth:grant-type:jwt-bearer grant. See OAuth Assertion.
  • Customer API token (CustomerAPIToken) — generated by the customer on their Integration Settings page, with the scopes they choose there. See Authorization for customers.
  • Client token (ClientToken) — a partner client_token, accepted only on the endpoints that list it. See Authentication for partners.
post/v1/currency-converter/raw

Request

  • Base URL
    https://gateway.remote.com
  • URL
    https://gateway.remote.com/v1/currency-converter/raw
  • Auth
    • OAuth 2
      Authorization code: /auth/oauth2/authorize
      Token URL: /auth/oauth2/token
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token
    • or OAuth 2
      Client credentials
      Token URL: /auth/oauth2/token
    • or HTTP bearer
    • or HTTP bearer

Request body

amountinteger required

The amount to convert in cents

source_currencystring required

The currency code to convert from

target_currencystring required

The currency code to convert to

Example request

{
  "amount": 1000,
  "source_currency": "USD",
  "target_currency": "EUR"
}

Response

Success

Example response

{
  "data": {
    "conversion_data": {
      "exchange_rate": 0.85,
      "source_amount": 1000,
      "source_currency": {
        "code": "CZK",
        "name": "Czech Koruna",
        "symbol": "Kč"
      },
      "target_amount": 850,
      "target_currency": {
        "code": "CZK",
        "name": "Czech Koruna",
        "symbol": "Kč"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.