Skip to main content

Add or replace exchange rates

POST 
/v1/fx-rates

Your own exchange rates for reporting. Nuntiq reports convert invoice amounts into a reporting currency (by default your tenant's base currency). Rates you load here win over Nuntiq's platform rates (central-bank sources), also when yours are for another period (your monthly rate beats a platform day rate). Each currency is looked up on its own: where you have no rate for a currency, the platform rate is used for that currency.

A rate is expressed against your base currency: 1 base currency = per_base units of the currency. Each rate belongs to a period: a day (one rate, rate_type close), a week starting on Monday or a month starting on the 1st (each with an average and a close rate). When you load day rates, the week and month rates of those periods are calculated from them, unless you loaded a week or month rate yourself.

Body: { "rates": [...] } or an array. Each item is either a rate (currency_code, period_type, period_start, rate_type, per_base) or a currency pair (from_currency, to_currency, rate, date: 1 from = rate to) where one side is your base currency; any other pair is refused. A rate for an existing currency, period and rate type replaces it. All rates are checked first: if one is not valid, nothing is saved (400 with the errors). At most 20000 rates per request.

Request​

Responses​

Saved