Currencies API (currencies)

The currencies module serves currencies, exchange rates with conversion and a central bank sync, and payment terms. The currency router lives in src/cluster_erp/server/routes/currencies.py and is mounted by this module. All 20 endpoints sit under /api/v1/currencies. For business meaning see the Currencies module page.

Group facts¶

Endpoint summary¶

One row per sub-module folder. The router prefix is added to the base path.

Currencies endpoints¶

Currency records, an update from the internet, and a seed action. The router has no prefix, so its paths sit directly under the module base path.

Exchange rates endpoints¶

Exchange rate records, a conversion read, and a central bank sync.

Payment terms endpoints¶

Payment term records.

Error codes¶

The table lists the error codes that code under src/cluster_erp/modules/currencies/ raises, found by a syntax-tree scan for AppError(...), the factories in src/cluster_erp/core/errors.py (not_found, conflict, protected, permission_denied, privilege_escalation, check_version), and HTTPException(...). A status of 400 is the AppError default (src/cluster_erp/core/errors.py:23). Guard errors (401, 403), the entitlement codes, and validation errors (422) apply to every route and are listed on Errors.

The currency router in src/cluster_erp/server/routes/currencies.py is included in the scan.

Events emitted¶

The table lists the contract classes that code under src/cluster_erp/modules/currencies/ passes directly to EventBus.emit, found by a syntax-tree scan. Events built in a variable first are not counted. The contracts are described in Contracts reference.

None found by the scan.

Related pages¶

• API reference
• Currencies module
• API conventions
• Errors
• Authentication and headers

Verified against commit 92f8051 on 2026-11-13.