Exchange Rates

Upsert exchange rate

PUT/api/v1/products/exchange-rates

Creates the pair if it doesn't exist, or updates it if it does — in either direction. Staff-only.

Requires Authorization

ADMIN, SUPPORT only

Authenticated action

Body parameters

`fromCurrency`stringrequired	e.g. USD.
`toCurrency`stringrequired	e.g. CDF.
`rate`numberrequired	Must be greater than 0.

Notes

If the existing pair is stored in the opposite direction, the rate is automatically inverted before saving.

Request

curl --request PUT \
  --url https://api.swiftgoma.com/api/v1/products/exchange-rates \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "fromCurrency": "<fromCurrency>",
  "toCurrency": "<toCurrency>",
  "rate": "<rate>"
}'

200Example response

{
  "success": true,
  "data": {
    "id": "fx_1a2b3c",
    "fromCurrency": "USD",
    "toCurrency": "CDF",
    "rate": "2800",
    "updatedBy": "admin_9f8e7d",
    "updatedAt": "2026-02-01T08:00:00.000Z"
  }
}