SwiftGoma.SwiftGoma

Search endpoints

Jump to any API endpoint by name, method, or path

Exchange Rates

Create exchange rate

POST/api/v1/products/exchange-rates

Creates a rate for a currency pair that doesn't have one yet in either direction. Staff-only.

Requires Authorization
ADMIN, SUPPORT only
Authenticated action

Body parameters

fromCurrencystringrequired
e.g. USD.
toCurrencystringrequired
e.g. CDF.
ratenumberrequired
Must be greater than 0.

Possible errors

409CONFLICTUn taux existe déjà entre USD et CDF (USD → CDF). Utilisez la mise à jour à la place.
Request
curl --request POST \
  --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>"
}'
201Example response
{
  "success": true,
  "data": {
    "id": "fx_1a2b3c",
    "fromCurrency": "USD",
    "toCurrency": "CDF",
    "rate": "2800",
    "updatedBy": "admin_9f8e7d",
    "updatedAt": "2026-02-01T08:00:00.000Z"
  }
}