Currency Conversion

Convert currency using dynamic rates

Convert currency using the rates Remote applies during employment creation and invoicing.

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

Request

  • Base URL
    https://gateway.remote.com
  • URL
    https://gateway.remote.com/v1/currency-converter
  • 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.