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/effective
Request
- Base URLhttps://gateway.remote.com
- URLhttps://gateway.remote.com/v1/currency-converter/effective
- Auth
- OAuth 2Authorization code: /auth/oauth2/authorizeToken URL: /auth/oauth2/token
- or OAuth 2Client credentialsToken URL: /auth/oauth2/token
- or OAuth 2Client credentialsToken URL: /auth/oauth2/token
- or OAuth 2Client credentialsToken URL: /auth/oauth2/token
- or HTTP bearer
- or HTTP bearer
Request body
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.