Skip to main content
POST
Preview live or historical exchange rates from the external provider
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /currencies/exchange-rates/fetch-live Preview-only — fetches rates from the external rates provider (fawazahmed0/exchange-api) and returns them without persisting anything; call POST /currencies/exchange-rates or the /bulk endpoint separately to save. Pass date (YYYY-MM-DD) for a historical lookup, or omit it for the latest rates. Rate-limited to one fetch per tenant per 60 seconds. Authorization: admin or higher (requireAdmin).

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
baseCurrency
string
required
Example:

"EUR"

quotedCurrencies
string[]
required
Minimum array length: 1
Example:
date
string<date>

YYYY-MM-DD. Omit for the latest live rates.

Response

Rates fetched (not persisted)

status
string
Example:

"success"

data
object[]
meta
object