FX

Endpointhttps://api.kontorion.eu/v1

List FX rate overrides

GET

https://api.kontorion.eu/v1

/fx/overrides

Returns paginated FX overrides for the active organization.

List FX rate overrides › query Parameters

limit

integer

Page size

cursor

string

Pagination cursor

List FX rate overrides › Responses

Paginated list of overrides

Create an FX rate override

POST

https://api.kontorion.eu/v1

/fx/overrides

Creates a manual override that takes precedence over the snapshotted ECB rate for a currency pair on a specific date or date range.

Create an FX rate override › Request Body

reason

string

snapshot_date

string

source_currency

string

target_currency

string

valid_from

string

nil → now()

valid_to

string

nil → open-ended

Create an FX rate override › Responses

Created

created_at

string

deleted_at

string

id

string

organization_id

string

reason

string

snapshot_date

string

SnapshotDate pins the override to a specific calendar day's rate snapshot — plain-date semantic, mirrors FXSnapshot.SnapshotDate. ValidFrom / ValidTo are TIMESTAMPTZ instants (the activation window of the override itself, which legitimately has wall-clock semantics — "this override kicks in at 09:00 Friday Berlin").

source_currency

string

target_currency

string

updated_at

string

valid_from

string

valid_to

string

workspace_id

string

POST/fx/overrides

curl --request POST \
  --url https://api.kontorion.eu/v1/fx/overrides \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}
'

shell

Example Request Body

{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}

json

Example Responses

{
  "created_at": "created_at",
  "deleted_at": "deleted_at",
  "id": "id",
  "organization_id": "organization_id",
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "updated_at": "updated_at",
  "valid_from": "valid_from",
  "valid_to": "valid_to",
  "workspace_id": "workspace_id"
}

json

application/json

Delete an FX rate override

DELETE

https://api.kontorion.eu/v1

/fx/overrides/{id}

Soft-deletes a manual FX override. The snapshotted rate becomes effective again for the affected window.

Delete an FX rate override › path Parameters

id

string · required

Override ID (UUID)

Delete an FX rate override › Responses

Override deleted

No data returned

Update an FX rate override

PATCH

https://api.kontorion.eu/v1

/fx/overrides/{id}

Updates the rate or active window of an existing manual FX override.

Update an FX rate override › path Parameters

id

string · required

Override ID (UUID)

Update an FX rate override › Request Body

reason

string

snapshot_date

string

valid_from

string

valid_to

string

Update an FX rate override › Responses

created_at

string

deleted_at

string

id

string

organization_id

string

reason

string

snapshot_date

string

source_currency

string

target_currency

string

updated_at

string

valid_from

string

valid_to

string

workspace_id

string

PATCH/fx/overrides/{id}

curl --request PATCH \
  --url https://api.kontorion.eu/v1/fx/overrides/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}
'

shell

Example Request Body

{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}

json

Example Responses

{
  "created_at": "created_at",
  "deleted_at": "deleted_at",
  "id": "id",
  "organization_id": "organization_id",
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "updated_at": "updated_at",
  "valid_from": "valid_from",
  "valid_to": "valid_to",
  "workspace_id": "workspace_id"
}

json

application/json

List FX snapshots for a date

GET

https://api.kontorion.eu/v1

/fx/snapshots

Returns all currency-pair snapshots for the supplied date (defaults to today, UTC).

List FX snapshots for a date › query Parameters

date

string

Date in YYYY-MM-DD format (default today UTC)

List FX snapshots for a date › Responses

object[]

created_at

string

id

string

rate

string

decimal string for precision

snapshot_date

string

SnapshotDate is the calendar day this rate snapshot represents. One snapshot per (date, source, target) — the rate is what the configured source (ECB, etc.) published for that day. Plain-date semantic: no clock, no zone. Postgres column type is DATE.

source

string

source_currency

string

target_currency

string

Get the latest FX snapshot for a currency pair

GET

https://api.kontorion.eu/v1

/fx/snapshots/latest

Returns the most recent FX snapshot at or before "now" for the given from→to pair. Used for ad-hoc conversion lookups.

Get the latest FX snapshot for a currency pair › query Parameters

from

string · required

Source ISO 4217 currency code

to

string · required

Target ISO 4217 currency code

Get the latest FX snapshot for a currency pair › Responses

created_at

string

id

string

rate

string

decimal string for precision

snapshot_date

string

source

string

source_currency

string

target_currency

string

FX sync status

GET

https://api.kontorion.eu/v1

/fx/sync-status

Reports the most recent snapshot date and the number of distinct snapshot dates over the last year. Useful for monitoring the FX-sync job.

FX sync status › Responses

Latest snapshot date and rolling 1-year coverage

E-Invoicing Identity Providers

Kontorion Billing API

FX

Endpointhttps://api.kontorion.eu/v1

List FX rate overrides

GET

https://api.kontorion.eu/v1

/fx/overrides

Returns paginated FX overrides for the active organization.

List FX rate overrides › query Parameters

limit

integer

Page size

cursor

string

Pagination cursor

List FX rate overrides › Responses

Paginated list of overrides

Create an FX rate override

POST

https://api.kontorion.eu/v1

/fx/overrides

Creates a manual override that takes precedence over the snapshotted ECB rate for a currency pair on a specific date or date range.

Create an FX rate override › Request Body

reason

string

snapshot_date

string

source_currency

string

target_currency

string

valid_from

string

nil → now()

valid_to

string

nil → open-ended

Create an FX rate override › Responses

Created

created_at

string

deleted_at

string

id

string

organization_id

string

reason

string

snapshot_date

string

source_currency

string

target_currency

string

updated_at

string

valid_from

string

valid_to

string

workspace_id

string

POST/fx/overrides

curl --request POST \
  --url https://api.kontorion.eu/v1/fx/overrides \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}
'

shell

Example Request Body

{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}

json

Example Responses

{
  "created_at": "created_at",
  "deleted_at": "deleted_at",
  "id": "id",
  "organization_id": "organization_id",
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "updated_at": "updated_at",
  "valid_from": "valid_from",
  "valid_to": "valid_to",
  "workspace_id": "workspace_id"
}

json

application/json

Delete an FX rate override

DELETE

https://api.kontorion.eu/v1

/fx/overrides/{id}

Soft-deletes a manual FX override. The snapshotted rate becomes effective again for the affected window.

Delete an FX rate override › path Parameters

id

string · required

Override ID (UUID)

Delete an FX rate override › Responses

Override deleted

No data returned

Update an FX rate override

PATCH

https://api.kontorion.eu/v1

/fx/overrides/{id}

Updates the rate or active window of an existing manual FX override.

Update an FX rate override › path Parameters

id

string · required

Override ID (UUID)

Update an FX rate override › Request Body

reason

string

snapshot_date

string

valid_from

string

valid_to

string

Update an FX rate override › Responses

created_at

string

deleted_at

string

id

string

organization_id

string

reason

string

snapshot_date

string

source_currency

string

target_currency

string

updated_at

string

valid_from

string

valid_to

string

workspace_id

string

PATCH/fx/overrides/{id}

curl --request PATCH \
  --url https://api.kontorion.eu/v1/fx/overrides/:id \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}
'

shell

Example Request Body

{
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "valid_from": "valid_from",
  "valid_to": "valid_to"
}

json

Example Responses

{
  "created_at": "created_at",
  "deleted_at": "deleted_at",
  "id": "id",
  "organization_id": "organization_id",
  "reason": "reason",
  "snapshot_date": "snapshot_date",
  "source_currency": "source_currency",
  "target_currency": "target_currency",
  "updated_at": "updated_at",
  "valid_from": "valid_from",
  "valid_to": "valid_to",
  "workspace_id": "workspace_id"
}

json

application/json

List FX snapshots for a date

GET

https://api.kontorion.eu/v1

/fx/snapshots

Returns all currency-pair snapshots for the supplied date (defaults to today, UTC).

List FX snapshots for a date › query Parameters

date

string

Date in YYYY-MM-DD format (default today UTC)

List FX snapshots for a date › Responses

object[]

created_at

string

id

string

rate

string

decimal string for precision

snapshot_date

string

source

string

source_currency

string

target_currency

string

Get the latest FX snapshot for a currency pair

GET

https://api.kontorion.eu/v1

/fx/snapshots/latest

Returns the most recent FX snapshot at or before "now" for the given from→to pair. Used for ad-hoc conversion lookups.

Get the latest FX snapshot for a currency pair › query Parameters

from

string · required

Source ISO 4217 currency code

to

string · required

Target ISO 4217 currency code

Get the latest FX snapshot for a currency pair › Responses

created_at

string

id

string

rate

string

decimal string for precision

snapshot_date

string

source

string

source_currency

string

target_currency

string

FX sync status

GET

https://api.kontorion.eu/v1

/fx/sync-status

Reports the most recent snapshot date and the number of distinct snapshot dates over the last year. Useful for monitoring the FX-sync job.

FX sync status › Responses

Latest snapshot date and rolling 1-year coverage

E-Invoicing Identity Providers