Sintropix FX Rates API: Read and Sync Currency Rates

The FX Rates API exposes the currency conversion rates Sintropix uses across every Entity. Rates are mirrored as published by Banco Central de Chile; the sync endpoint refreshes the stored rates and is restricted to staff. The read endpoints are Entity-independent because rates are global. Sintropix tracks eight currency pairs, all quoted in CLP. Each pair comes from one Banco Central series, named in the rate’s source:

Pair	`source`
`USD/CLP`	`dolar_observado`
`EUR/CLP`, `GBP/CLP`	`tipo_cambio_observado`
`MXN/CLP`, `COP/CLP`, `ARS/CLP`, `BRL/CLP`, `PEN/CLP`	`tipo_cambio_referencial`

A line in one of these currencies, booked in a CLP Entity, gets the pair’s rate as its default. A pair outside this list has no stored rate, so a lookup for it returns 404. Rates are stored exactly as Banco Central de Chile publishes them, with at most two decimals. For currencies worth less than one Chilean peso, such as COP and ARS, the rate is below one (for example "0.24"), and the published rounding carries through to the converted amount.

Open in the app. This resource has a page in the Sintropix web app at https://app.sintropix.com/organizations/{organizationId}/settings/fx-rates, where each id in braces is the same UUID as in the API route or response. The page lives in the Organization's Configuración, under Tipos de cambio, and shows the same global rates in every Organization. When you mention a record to a user, include that link. See Link to the App for the full URL grammar.

The FX Rate object

Field	Type	Description
`baseCurrency`	string	ISO 4217 code of the base currency, for example `USD`.
`quoteCurrency`	string	ISO 4217 code of the quote currency, for example `CLP`.
`rateDate`	string (`YYYY-MM-DD`)	The publication date of the rate.
`rate`	decimal string	One major unit of `baseCurrency` equals `rate` major units of `quoteCurrency`, for example `"943.25"`, or `"0.24"` for `COP/CLP`. Always a string, never a float.
`source`	`dolar_observado` \| `tipo_cambio_observado` \| `tipo_cambio_referencial`	Which Banco Central series the rate came from.
`createdAt`	ISO 8601 timestamp	When the rate was stored.

GET `/fx-rates`

Return the FX rate for a currency pair on a given date. The date is the date being valued (an Invoice’s issue date, for example), not necessarily a publication date: the response is the most recent rate published on or before it, and rateDate tells you which day that was. Query parameters

Field	Type	Required	Description
`baseCurrency`	string	Yes	Base currency code, for example `USD`.
`quoteCurrency`	string	Yes	Quote currency code, for example `CLP`.
`date`	string (`YYYY-MM-DD`)	Yes	The date to value.

Response: an FX Rate object.

curl "https://api.sintropix.com/api/fx-rates?baseCurrency=USD&quoteCurrency=CLP&date=2025-12-31" \
  -H "x-api-key: $SINTROPIX_API_KEY"

{
  "baseCurrency": "USD",
  "quoteCurrency": "CLP",
  "rateDate": "2025-12-31",
  "rate": "943.25",
  "source": "dolar_observado",
  "createdAt": "2025-12-31T12:05:00.000Z"
}

GET `/fx-rates/recent`

List the most recent published rates across all tracked currency pairs: up to 100 rates, newest rateDate first.

Response: array of FX Rate objects.

POST `/fx-rates/sync` (staff only)

Force a sync of published rates from Banco Central de Chile. The response summarizes what was fetched and stored. Every tracked series is fetched independently, so one failing series does not withhold the others. Body

Field	Type	Required	Description
`startDate`	string (`YYYY-MM-DD`)	No	First publication date to fetch. Must be given together with `endDate`, and be on or before it.
`endDate`	string (`YYYY-MM-DD`)	No	Last publication date to fetch. Must be given together with `startDate`.

An empty body (or no body) syncs the default trailing window: the last 10 days ending today, on the Chilean calendar. Response: { series: [...] }, one entry per tracked series in fetch order:

Field	Type	Description
`baseCurrency`	string	Base currency of the series.
`quoteCurrency`	string	Quote currency of the series.
`source`	`dolar_observado` \| `tipo_cambio_observado` \| `tipo_cambio_referencial`	The series’ source.
`fetched`	integer	Rows seen in the provider window.
`inserted`	integer	Rows that were genuinely new. Already-stored rates are not counted.
`failureMessage`	string	Present only when the series failed; `fetched` and `inserted` are then `0`.

Status: 200.

curl -X POST "https://api.sintropix.com/api/fx-rates/sync" \
  -H "x-api-key: $SINTROPIX_API_KEY" \
  -H "x-audit-actor: my-agent" \
  -H "x-audit-reason: Backfill December rates" \
  -H "Content-Type: application/json" \
  -d '{ "startDate": "2025-12-01", "endDate": "2025-12-31" }'

{
  "series": [
    { "baseCurrency": "USD", "quoteCurrency": "CLP", "source": "dolar_observado", "fetched": 22, "inserted": 3 },
    { "baseCurrency": "EUR", "quoteCurrency": "CLP", "source": "tipo_cambio_observado", "fetched": 22, "inserted": 3 },
    { "baseCurrency": "MXN", "quoteCurrency": "CLP", "source": "tipo_cambio_referencial", "fetched": 0, "inserted": 0, "failureMessage": "Upstream request timed out" }
  ]
}

This route requires the staff Role in at least one Organization. Other callers receive 403 with PERMISSION_DENIED_ERROR.

Status codes

Status	Meaning
`200`	Success.
`400`	Validation error on query or body, or missing `x-audit-actor` or `x-audit-reason` on an API-key sync call.
`403`	`POST /sync` called by a User with no `staff` Role in any Organization.
`404`	No rate found for the requested currency pair on or before the given date (`FX_RATE_NOT_FOUND_ERROR`).

A sync doesn’t fail when Banco Central de Chile does: a series it can’t fetch comes back with failureMessage in the 200 response.

Get Started

Ledger

Banking

Documents

Reports & Audit

Sources & Integrations

Platform

Sintropix FX Rates API: Read and Sync Currency Rates

The FX Rate object

GET `/fx-rates`

GET `/fx-rates/recent`

POST `/fx-rates/sync` (staff only)

Status codes

​The FX Rate object

​GET /fx-rates

​GET /fx-rates/recent

​POST /fx-rates/sync (staff only)

​Status codes

The FX Rate object

GET `/fx-rates`

GET `/fx-rates/recent`

POST `/fx-rates/sync` (staff only)

Status codes