Skip to main content
POST
/
v1
/
global-payout
/
money
/
convert
cURL
curl --request POST \
  --url https://api.nomba.com/v1/global-payout/money/convert \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '
{
  "amount": 15,
  "currency": "USD",
  "destinationCurrency": "EUR",
  "transactionType": "EXCHANGE",
  "sourceCountryIsoCode": "NG"
}
'
{
  "code": "00",
  "description": "Successful",
  "data": {
    "fromAmount": 15,
    "fromCurrency": "USD",
    "fromFormatted": "$15.00",
    "toAmount": 13.04,
    "toCurrency": "EUR",
    "toFormatted": "13,04 €",
    "spreadAmount": 0.12,
    "spreadCurrency": "EUR",
    "exchangeRateId": "01kkk4b7rh8pcvtw1s1nxs144s",
    "currencyPairName": "EUR/USD",
    "feeAmount": 0,
    "feeCurrency": "USD"
  }
}

Headers

​
Authorization
string
required

Bearer token for authentication.

Example:

"Bearer <token>"

​
accountId
string
required

The parent accountId of the business.

Example:

"890022ce-bae0-45c1-9b9d-ee7872e6ca27"

Body

application/json

Currency conversion payload

​
amount
number
required
Example:

15

​
currency
string
required

ISO 4217 source currency code.

Example:

"USD"

​
destinationCurrency
string
required

ISO 4217 destination currency code.

Example:

"EUR"

​
transactionType
string
required
Example:

"EXCHANGE"

​
sourceCountryIsoCode
string
required
Example:

"NG"

Response

200 - application/json

Conversion calculated successfully.

​
code
string
Example:

"00"

​
description
string
Example:

"Successful"

​
data
object