Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
Converts an amount between two currencies.
from
string
required
Source currency to convert from. 3-letter ISO 4217 code, uppercase.
Required string length: 3
Example:
"USD"
to
string
required
Target currency to convert to. 3-letter ISO 4217 code, uppercase.
Required string length: 3
Example:
"GBP"
amount
number
required
Amount to convert, expressed in the source currency. Must be greater than zero.
Required range: x > 0
Example:
250
Response
200 - application/json
The converted amount and the rate used.
success
boolean
Whether the request was processed successfully. Declines return HTTP 200 with success: false.
message
string
Human-readable result message.
code
string
Machine-readable result code. See the Error Codes reference.
data
object
The response payload.
Hide child attributes
data.from
string
Source currency the amount was converted from.
data.to
string
Target currency the amount was converted to.
data.amount
number
Original amount submitted, in the source currency.
data.convertedAmount
number
Converted amount in the target currency, rounded down to 2 decimal places.
data.rate
number
Exchange rate applied to the conversion.
data.fetchedAt
string<date-time>
UTC timestamp of when the rate was retrieved from the rate provider.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Jupico","colors":{"primary":"#292929","light":"#cdcdcd","dark":"#171717"},"logo":{"light":"https://mintcdn.com/jupico/WF42wWm1iAwRSzCk/images/JupicoBlackLogo.png?fit=max\u0026auto=format\u0026n=WF42wWm1iAwRSzCk\u0026q=85\u0026s=dc9e36bca54fe697b1b99f6f0a8d93f0","dark":"https://mintcdn.com/jupico/WF42wWm1iAwRSzCk/images/JupicoWhiteLogo.png?fit=max\u0026auto=format\u0026n=WF42wWm1iAwRSzCk\u0026q=85\u0026s=2f922c06b240c3e8e1d3ba6919e4bd0e"},"favicon":{"light":"https://mintcdn.com/jupico/RFrdZu1UP2fi56xT/images/favicon.png?fit=max\u0026auto=format\u0026n=RFrdZu1UP2fi56xT\u0026q=85\u0026s=d9e461afbf75b0c5d34e2c2d1062266d","dark":"https://mintcdn.com/jupico/RFrdZu1UP2fi56xT/images/favicon-light.png?fit=max\u0026auto=format\u0026n=RFrdZu1UP2fi56xT\u0026q=85\u0026s=874f3d60c07928df5dcbb76b5cf548c0"},"api":{"openapi":"openapi.json","params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","python","javascript","node"],"prefill":true,"autogenerate":true},"url":"full"},"appearance":{"default":"light"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://jupico.com/contact/","label":"Support"}],"primary":{"type":"button","label":"Contact Sales","href":"https://jupico.com/demo/"}},"icons":{"library":"fontawesome"},"contextual":{"options":["copy","chatgpt","claude","view"],"display":"toc"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"schema":true},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"jupico","hasAudioNarration":false,"actualSubdomain":"jupico","customDomains":["docs.jupico.com"],"gitSource":{"type":"github","owner":"fiz-jupico","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"}},"buildId":"6afcbc41c8a0f18522e96851","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":188},{"language":"default","tag":"Product Guides","count":31},{"language":"default","tag":"Query","count":22},{"language":"default","tag":"API Overview","count":11},{"language":"default","tag":"Accept Payments","count":10},{"language":"default","tag":"Subscriptions","count":10},{"language":"default","tag":"Payouts","count":7},{"language":"default","tag":"Onboarding Invites","count":7},{"language":"default","tag":"Card Transactions","count":6},{"language":"default","tag":"Hosted Products","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@jupico.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/currency-exchange-api/convert-currency","slug":"/api-reference/currency-exchange-api/convert-currency","pageMetadata":{"title":"Convert currency","description":"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/exchange-rates/convert","href":"/api-reference/currency-exchange-api/convert-currency","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Convert currency","description":"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/exchange-rates/convert","href":"/api-reference/currency-exchange-api/convert-currency","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Currency Exchange API"],"summary":"Convert currency","description":"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.","operationId":"convertCurrency","requestBody":"badc37f6-63f9-4930-a4cf-7a21712b9198","security":["430fa5b8-b188-4386-8596-d6f61927b3a3"],"responses":{"200":"73c94491-b0ba-41cb-a6d4-6357ccc66390"},"method":"post","type":"path","servers":["034172e6-e076-4763-904f-1dca8d9cd729"],"path":"/v1/exchange-rates/convert","baseUrlOptions":["https://sandbox-platform.jupico.com"],"title":"Convert currency","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","node"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.from":"USD","body.to":"GBP","body.amount":250}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"description":"Converts an amount between two currencies.","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","minLength":3,"maxLength":3,"description":"Source currency to convert from. 3-letter ISO 4217 code, uppercase.","example":"USD","isRequired":true,"uniqueKey":"from","typeLabel":"string"},"to":{"type":"string","minLength":3,"maxLength":3,"description":"Target currency to convert to. 3-letter ISO 4217 code, uppercase.","example":"GBP","isRequired":true,"uniqueKey":"to","typeLabel":"string"},"amount":{"type":"number","minimum":0,"exclusiveMinimum":true,"description":"Amount to convert, expressed in the source currency. Must be greater than zero.","example":250,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"}},"required":["from","to","amount"],"uniqueKey":"","typeLabel":"object"},"examples":{"convertCurrency":{"title":"convertCurrency","summary":"Convert 250.00 USD to GBP","value":{"from":"USD","to":"GBP","amount":250}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"73c94491-b0ba-41cb-a6d4-6357ccc66390":{"description":"The converted amount and the rate used.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was processed successfully. Declines return HTTP 200 with `success: false`.","uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Human-readable result message.","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable result code. See the Error Codes reference.","uniqueKey":"code","typeLabel":"string"},"data":{"type":"object","properties":{"from":{"type":"string","description":"Source currency the amount was converted from.","uniqueKey":"data.from","typeLabel":"string"},"to":{"type":"string","description":"Target currency the amount was converted to.","uniqueKey":"data.to","typeLabel":"string"},"amount":{"type":"number","description":"Original amount submitted, in the source currency.","uniqueKey":"data.amount","typeLabel":"number"},"convertedAmount":{"type":"number","description":"Converted amount in the target currency, rounded down to 2 decimal places.","uniqueKey":"data.convertedAmount","typeLabel":"number"},"rate":{"type":"number","description":"Exchange rate applied to the conversion.","uniqueKey":"data.rate","typeLabel":"number"},"fetchedAt":{"type":"string","format":"date-time","description":"UTC timestamp of when the rate was retrieved from the rate provider.","uniqueKey":"data.fetchedAt","typeLabel":"string\u003cdate-time>"}},"description":"The response payload.","uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"convertCurrencyResponse":{"title":"convertCurrencyResponse","summary":"Amount converted successfully","value":{"success":true,"message":"succeeded","code":"0","data":{"from":"USD","to":"GBP","amount":250,"convertedAmount":196.12,"rate":0.7845,"fetchedAt":"2026-08-14T16:20:45.331Z"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"430fa5b8-b188-4386-8596-d6f61927b3a3":{"basicAuth":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basicAuth"}}},"servers":{"034172e6-e076-4763-904f-1dca8d9cd729":{"url":"https://sandbox-platform.jupico.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"jupico","siteName":"Jupico","title":"Convert currency - Jupico","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/currency-exchange-api/convert-currency.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Jupico\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Convert currency - Jupico\">\u003cmeta data-mint-head property=\"og:description\" content=\"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Jupico\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://jupico.mintlify.site/_mintlify/api/og/v2?division=Currency+Exchange+API\u0026amp;title=Convert+currency\u0026amp;description=Converts+an+amount+from+one+currency+to+another.+convertedAmount+is+rounded+down+to+2+decimal+places.\u0026amp;theme=6d5f977131b976ac16fbf2c1\u0026amp;signature=9000688bb50fe6bda5c3fd1aaf5effdb228356033a4600a8dc3456c427dfc5fb\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Convert currency - Jupico\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://jupico.mintlify.site/_mintlify/api/og/v2?division=Currency+Exchange+API\u0026amp;title=Convert+currency\u0026amp;description=Converts+an+amount+from+one+currency+to+another.+convertedAmount+is+rounded+down+to+2+decimal+places.\u0026amp;theme=6d5f977131b976ac16fbf2c1\u0026amp;signature=9000688bb50fe6bda5c3fd1aaf5effdb228356033a4600a8dc3456c427dfc5fb\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/jupico/gDU1_codmOnXopzN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Jupico\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#292929\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/currency-exchange-api/convert-currency.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.jupico.com/#organization\",\"name\":\"Jupico\",\"url\":\"https://docs.jupico.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/jupico/WF42wWm1iAwRSzCk/images/JupicoBlackLogo.png?fit=max\u0026auto=format\u0026n=WF42wWm1iAwRSzCk\u0026q=85\u0026s=dc9e36bca54fe697b1b99f6f0a8d93f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.jupico.com#website\",\"name\":\"Jupico\",\"url\":\"https://docs.jupico.com\",\"publisher\":{\"@id\":\"https://docs.jupico.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency#webpage\",\"url\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency\",\"name\":\"Convert currency\",\"description\":\"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.\",\"isPartOf\":{\"@id\":\"https://docs.jupico.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.jupico.com/api-reference/status/check-api-status\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Currency Exchange API\",\"item\":\"https://docs.jupico.com/api-reference/currency-exchange-api/get-exchange-rates\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Convert currency\",\"item\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency#apireference\",\"headline\":\"Convert currency\",\"name\":\"Convert currency\",\"description\":\"Converts an amount from one currency to another. convertedAmount is rounded down to 2 decimal places.\",\"url\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency\",\"mainEntityOfPage\":{\"@id\":\"https://docs.jupico.com/api-reference/currency-exchange-api/convert-currency#webpage\"},\"publisher\":{\"@id\":\"https://docs.jupico.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.jupico.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Jupico\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Jupico\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/currency-exchange-api/convert-currency.md","siteName":"Jupico","nav":{"global":null,"tabs":[{"tab":"Product Guides","pages":[{"title":"Product Guides","href":"/docs/overview"}]},{"tab":"API Reference","groups":[{"group":"API Overview","pages":[{"title":"Jupico API Overview: Payments, Onboarding, and Payouts","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"Jupico API authentication with HTTP Basic credentials","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Jupico Sandbox Environments and Test Data Reference","sidebarTitle":"Environments \u0026 Testing Data","href":"/api-reference/environments-testing-data"},{"title":"Jupico API Response Envelope and Payload Structure","sidebarTitle":"Responses","href":"/api-reference/responses"},{"title":"Jupico API HTTP Status Codes and Transaction States","sidebarTitle":"Status Codes","href":"/api-reference/status-codes"},{"title":"Handling Jupico Transaction Statuses and Next Steps","sidebarTitle":"Transaction Status Handling","href":"/api-reference/transaction-status-handling"},{"title":"Jupico API Error Handling: Retries and Idempotency","sidebarTitle":"Error Handling","href":"/api-reference/error-handling"},{"title":"Jupico API Error Codes: Causes and Remediation Steps","sidebarTitle":"Error Codes","href":"/api-reference/error-codes"},{"title":"Jupico API Timeout Handling: Safe Retries and Recovery","sidebarTitle":"Timeout Handling","href":"/api-reference/timeout-handling"},{"title":"Jupico Webhooks: Real-Time Payment Event Notifications","sidebarTitle":"Webhooks","href":"/api-reference/webhooks"},{"title":"API go-live checklist: sandbox to production","sidebarTitle":"Go-Live Checklist","href":"/api-reference/go-live-checklist"}]},{"group":"API Reference","pages":[{"group":"Status","pages":[{"title":"Check API status","deprecated":null,"version":null,"openapi":"/openapi.json get /status","href":"/api-reference/status/check-api-status"}]},{"group":"Onboarding Invites","pages":[{"title":"Create an invite","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/onboardinginvites","href":"/api-reference/onboarding-invites/create-an-invite"},{"title":"Create and send an invite","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/onboardinginvites/createandsend","href":"/api-reference/onboarding-invites/create-and-send-an-invite"},{"title":"Send an invite","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/onboardinginvites/send","href":"/api-reference/onboarding-invites/send-an-invite"},{"title":"Create multiple invites","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/onboardinginvites/createmany","href":"/api-reference/onboarding-invites/create-multiple-invites"},{"title":"Create an additional-MID invite","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/onboardinginvites/addsubmerchant","href":"/api-reference/onboarding-invites/create-an-additional-mid-invite"},{"title":"Update an invite","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/onboardinginvites/update","href":"/api-reference/onboarding-invites/update-an-invite"},{"title":"Cancel an invite","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/onboardinginvites/delete","href":"/api-reference/onboarding-invites/cancel-an-invite"}]},{"group":"Provisioning","pages":[{"title":"Create an applicant","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/provisioning/applicant","href":"/api-reference/provisioning/create-an-applicant"},{"title":"Create an application","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/provisioning/application","href":"/api-reference/provisioning/create-an-application"},{"title":"Update an application","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/provisioning/application/update","href":"/api-reference/provisioning/update-an-application"},{"title":"Create a submerchant","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/provisioning/submerchant","href":"/api-reference/provisioning/create-a-submerchant"},{"title":"Update a submerchant","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/provisioning/submerchant/update","href":"/api-reference/provisioning/update-a-submerchant"}]},{"group":"Session","pages":[{"title":"Create a browser session","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sessions/browser/authorize","href":"/api-reference/session/create-a-browser-session"}]},{"group":"Tokenization","pages":[{"title":"Convert a one-time token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/tokenization/converttopermanent","href":"/api-reference/tokenization/convert-a-one-time-token"},{"title":"Tokenize raw card data","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/tokenization/creditcard/raw","href":"/api-reference/tokenization/tokenize-raw-card-data"},{"title":"Tokenize raw bank account data","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/tokenization/bankaccount/raw","href":"/api-reference/tokenization/tokenize-raw-bank-account-data"}]},{"group":"Customer","pages":[{"title":"Create a customer","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/customers/","href":"/api-reference/customer/create-a-customer"},{"title":"Update a customer","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/customers/update","href":"/api-reference/customer/update-a-customer"},{"title":"Delete a customer","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/customers/delete","href":"/api-reference/customer/delete-a-customer"}]},{"group":"Card Transactions","pages":[{"title":"Process a card sale","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/creditcard/sale","href":"/api-reference/card-transactions/process-a-card-sale"},{"title":"Authorize a card","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/creditcard/authorization","href":"/api-reference/card-transactions/authorize-a-card"},{"title":"Capture an authorization","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/creditcard/capture","href":"/api-reference/card-transactions/capture-an-authorization"},{"title":"Void a card transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/creditcard/void","href":"/api-reference/card-transactions/void-a-card-transaction"},{"title":"Refund a card transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/creditcard/refund","href":"/api-reference/card-transactions/refund-a-card-transaction"},{"title":"Roll back a card transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/creditcard/rollback","href":"/api-reference/card-transactions/roll-back-a-card-transaction"}]},{"group":"eCheck Transactions","pages":[{"title":"Process an eCheck sale","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/echeck/sale","href":"/api-reference/echeck-transactions/process-an-echeck-sale"},{"title":"Void an eCheck transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/echeck/void","href":"/api-reference/echeck-transactions/void-an-echeck-transaction"},{"title":"Refund an eCheck transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/echeck/refund","href":"/api-reference/echeck-transactions/refund-an-echeck-transaction"},{"title":"Roll back an eCheck transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/transactions/echeck/rollback","href":"/api-reference/echeck-transactions/roll-back-an-echeck-transaction"},{"title":"Tokenize a bank account","deprecated":true,"version":null,"openapi":"/openapi.json post /v1/transactions/echeck/tokenize","href":"/api-reference/echeck-transactions/tokenize-a-bank-account"}]},{"group":"Checkouts","pages":[{"title":"Create a checkout session","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/checkouts","href":"/api-reference/checkouts/create-a-checkout-session"},{"title":"Update a checkout session","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/checkouts/update","href":"/api-reference/checkouts/update-a-checkout-session"},{"title":"Deactivate a checkout session","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/checkouts/deactivate","href":"/api-reference/checkouts/deactivate-a-checkout-session"},{"title":"Delete a checkout session","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/checkouts/delete","href":"/api-reference/checkouts/delete-a-checkout-session"}]},{"group":"Payment Links","pages":[{"title":"Create a payment link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/paymentlinks","href":"/api-reference/payment-links/create-a-payment-link"},{"title":"Update a payment link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/paymentlinks/update","href":"/api-reference/payment-links/update-a-payment-link"},{"title":"Deactivate a payment link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/paymentlinks/deactivate","href":"/api-reference/payment-links/deactivate-a-payment-link"},{"title":"Delete a payment link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/paymentlinks/delete","href":"/api-reference/payment-links/delete-a-payment-link"}]},{"group":"Invoices","pages":[{"title":"Create an invoice","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/invoices","href":"/api-reference/invoices/create-an-invoice"},{"title":"Send an invoice","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/invoices/send","href":"/api-reference/invoices/send-an-invoice"},{"title":"Update an invoice","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/invoices/update","href":"/api-reference/invoices/update-an-invoice"},{"title":"Void an invoice","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/invoices/void","href":"/api-reference/invoices/void-an-invoice"},{"title":"Delete an invoice","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/invoices/delete","href":"/api-reference/invoices/delete-an-invoice"}]},{"group":"Subscriptions","pages":[{"title":"Create a plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/plan","href":"/api-reference/subscriptions/create-a-plan"},{"title":"Update a plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/plan/update","href":"/api-reference/subscriptions/update-a-plan"},{"title":"Activate a plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/plan/activate","href":"/api-reference/subscriptions/activate-a-plan"},{"title":"Deactivate a plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/plan/deactivate","href":"/api-reference/subscriptions/deactivate-a-plan"},{"title":"Delete a plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/plan/delete","href":"/api-reference/subscriptions/delete-a-plan"},{"title":"Create a subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions","href":"/api-reference/subscriptions/create-a-subscription"},{"title":"Update a subscription payment token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/update/paymenttoken","href":"/api-reference/subscriptions/update-a-subscription-payment-token"},{"title":"Activate a subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/activate","href":"/api-reference/subscriptions/activate-a-subscription"},{"title":"Deactivate a subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/deactivate","href":"/api-reference/subscriptions/deactivate-a-subscription"},{"title":"Delete a subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subscriptions/delete","href":"/api-reference/subscriptions/delete-a-subscription"}]},{"group":"Installments","pages":[{"title":"Create an installment plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/installments","href":"/api-reference/installments/create-an-installment-plan"},{"title":"Activate an installment plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/installments/activate","href":"/api-reference/installments/activate-an-installment-plan"},{"title":"Deactivate an installment plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/installments/deactivate","href":"/api-reference/installments/deactivate-an-installment-plan"},{"title":"Update an installment payment token","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/installments/update/paymenttoken","href":"/api-reference/installments/update-an-installment-payment-token"},{"title":"Delete an installment plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/installments/delete","href":"/api-reference/installments/delete-an-installment-plan"}]},{"group":"Payouts","pages":[{"title":"Create a payout instruction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payouts/instruction","href":"/api-reference/payouts/create-a-payout-instruction"},{"title":"Create a card-balance payout","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payouts/creditcard/instruction","href":"/api-reference/payouts/create-a-card-balance-payout"},{"title":"Create an eCheck-balance payout","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payouts/echeck/instruction","href":"/api-reference/payouts/create-an-echeck-balance-payout"},{"title":"Void a payout instruction","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/payouts/instruction/void","href":"/api-reference/payouts/void-a-payout-instruction"}]},{"group":"Query","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/transactions","href":"/api-reference/query/list-transactions"},{"title":"Get a transaction timeline","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/transactions/timeline","href":"/api-reference/query/get-a-transaction-timeline"},{"title":"Get a transaction receipt","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/transactions/receipt","href":"/api-reference/query/get-a-transaction-receipt"},{"title":"List fees","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/fees","href":"/api-reference/query/list-fees"},{"title":"List merchant bank accounts","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/merchants/bankaccounts","href":"/api-reference/query/list-merchant-bank-accounts"},{"title":"List merchant applications","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/merchants/applications","href":"/api-reference/query/list-merchant-applications"},{"title":"List onboarding invites","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/onboardinginvites","href":"/api-reference/query/list-onboarding-invites"},{"title":"List submerchant settlements","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/settlements/submerchant","href":"/api-reference/query/list-submerchant-settlements"},{"title":"List Service Provider settlements","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/settlements/service-provider","href":"/api-reference/query/list-service-provider-settlements"},{"title":"List payout instructions","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/payouts/instructions","href":"/api-reference/query/list-payout-instructions"},{"title":"Check available balance","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/payouts/balance/available","href":"/api-reference/query/check-available-balance"},{"title":"Check available card balance","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/payouts/balance/creditcard/available","href":"/api-reference/query/check-available-card-balance"},{"title":"Check available eCheck balance","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/payouts/balanc/echeck/available","href":"/api-reference/query/check-available-echeck-balance"},{"title":"List disputes","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/disputes","href":"/api-reference/query/list-disputes"},{"title":"Get dispute history","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/disputes/chartslines","href":"/api-reference/query/get-dispute-history"},{"title":"List checkout sessions","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/checkouts","href":"/api-reference/query/list-checkout-sessions"},{"title":"List payment links","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/paymentlinks","href":"/api-reference/query/list-payment-links"},{"title":"List invoices","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/invoices","href":"/api-reference/query/list-invoices"},{"title":"List subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/subscriptions","href":"/api-reference/query/list-subscriptions"},{"title":"List plans","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/subscriptions/plan","href":"/api-reference/query/list-plans"},{"title":"Get a plan","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/subscriptions/plan/{planId}","href":"/api-reference/query/get-a-plan"},{"title":"List installment plans","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/query/installments","href":"/api-reference/query/list-installment-plans"}]},{"group":"Currency Exchange API","pages":[{"title":"Get exchange rates","description":"Returns exchange rates for a given base currency. If symbols is omitted, all supported currencies are returned.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/exchange-rates/rates","href":"/api-reference/currency-exchange-api/get-exchange-rates"},{"title":"Convert currency","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/exchange-rates/convert","href":"/api-reference/currency-exchange-api/convert-currency"},{"title":"Get supported currencies","description":"Returns the list of all supported currency codes, sorted alphabetically.","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/exchange-rates/supported-currencies","href":"/api-reference/currency-exchange-api/get-supported-currencies"}]}]},{"group":"Resources","pages":[{"title":"Jupico Query API: Filtering, Sorting, and Pagination","sidebarTitle":"Query Capabilities","href":"/api-reference/query-capabilities"}]}]}]},"basePath":"","title":"Convert currency - Jupico","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}