Currencies

Endpointhttps://api.kontorion.eu/v1

List workspace currencies

GET

https://api.kontorion.eu/v1

/currencies

Returns the currencies enabled for the active workspace, including reference counts to plans, prices and other entities.

List workspace currencies › Responses

object[]

billing_enabled

boolean

catalog_enabled

boolean

created_at

string

currency_code

string

object

updated_at

string

workspace_id

string

Enable a currency for the workspace

POST

https://api.kontorion.eu/v1

/currencies

Adds a currency (3-letter ISO 4217 code) to the workspace's allowlist.

Enable a currency for the workspace › Request Body

billing_enabled

boolean

catalog_enabled

boolean

currency_code

string

Enable a currency for the workspace › Responses

Created

billing_enabled

boolean

catalog_enabled

boolean

created_at

string

currency_code

string

object

updated_at

string

workspace_id

string

POST/currencies

curl --request POST \
  --url https://api.kontorion.eu/v1/currencies \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing_enabled": true,
  "catalog_enabled": true,
  "currency_code": "currency_code"
}
'

shell

Example Request Body

{
  "billing_enabled": true,
  "catalog_enabled": true,
  "currency_code": "currency_code"
}

json

Example Responses

{
  "billing_enabled": true,
  "catalog_enabled": true,
  "created_at": "created_at",
  "currency_code": "currency_code",
  "references": {
    "costs": 0,
    "credit_notes": 0,
    "customers": 0,
    "invoices": 0,
    "prices": 0,
    "subscriptions": 0,
    "total": 0,
    "wallets": 0
  },
  "updated_at": "updated_at",
  "workspace_id": "workspace_id"
}

json

application/json

Disable a workspace currency

DELETE

https://api.kontorion.eu/v1

/currencies/{code}

Removes a currency from the workspace's allowlist. Fails with 409 if the currency is still referenced by active plans, prices, or balances.

Disable a workspace currency › path Parameters

code

string · required

ISO 4217 currency code (uppercase)

Disable a workspace currency › Responses

Currency disabled

No data returned

Update a workspace currency

PATCH

https://api.kontorion.eu/v1

/currencies/{code}

Updates display settings for an enabled currency (e.g. rounding mode, default-base flag).

Update a workspace currency › path Parameters

code

string · required

ISO 4217 currency code (uppercase)

Update a workspace currency › Request Body

billing_enabled

boolean

catalog_enabled

boolean

Update a workspace currency › Responses

billing_enabled

boolean

catalog_enabled

boolean

created_at

string

currency_code

string

object

updated_at

string

workspace_id

string

Tags Portal

List workspace currencies

GET

https://api.kontorion.eu/v1

/currencies

Returns the currencies enabled for the active workspace, including reference counts to plans, prices and other entities.

List workspace currencies › Responses

object[]

billing_enabled

boolean

catalog_enabled

boolean

created_at

string

currency_code

string

object

updated_at

string

workspace_id

string

Enable a currency for the workspace

POST

https://api.kontorion.eu/v1

/currencies

Adds a currency (3-letter ISO 4217 code) to the workspace's allowlist.

Enable a currency for the workspace › Request Body

billing_enabled

boolean

catalog_enabled

boolean

currency_code

string

Enable a currency for the workspace › Responses

Created

billing_enabled

boolean

catalog_enabled

boolean

created_at

string

currency_code

string

object

updated_at

string

workspace_id

string

Disable a workspace currency

DELETE

https://api.kontorion.eu/v1

/currencies/{code}

Removes a currency from the workspace's allowlist. Fails with 409 if the currency is still referenced by active plans, prices, or balances.

Disable a workspace currency › path Parameters

code

string · required

ISO 4217 currency code (uppercase)

Disable a workspace currency › Responses

Currency disabled

No data returned

Update a workspace currency

PATCH

https://api.kontorion.eu/v1

/currencies/{code}

Updates display settings for an enabled currency (e.g. rounding mode, default-base flag).

Update a workspace currency › path Parameters

code

string · required

ISO 4217 currency code (uppercase)

Update a workspace currency › Request Body

billing_enabled

boolean

catalog_enabled

boolean

Update a workspace currency › Responses

billing_enabled

boolean

catalog_enabled

boolean

created_at

string

currency_code

string

object

updated_at

string

workspace_id

string