Skip to main content
POST
Convert currency

Authorizations

Authorization
string
header
required

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.

Last modified on August 20, 2026