CURRENCY: Currency
A currency reference record with symbol, ISO code, precision, and exchange rate for multi-currency financial support.
CURRENCY definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches CURRENCY.Entity properties
| Property | Value |
|---|---|
| Entity code | CURRENCY |
| Display name | Currency |
| Plural | Currencies |
| Level | 250 |
Use cases
CURRENCY is a reference data entity that enables multi-currency financial operations across the platform. It uses the simple grid view for straightforward data management. The name field stores the full currency name (e.g., 'British Pound Sterling'), symbol stores the display character (e.g., '£', '$', '€'), and code stores the ISO 4217 currency code (e.g., 'GBP', 'USD'). The precision field controls decimal places for rounding (typically 2 for most currencies, 0 for some like JPY), which is critical for accurate financial calculations in entities like project finance trackers, budgets, and day rates. The fx (exchange rate) field stores the conversion rate relative to a base currency, enabling cost comparisons and consolidated reporting across multi-national operations. All fields except precision are displayed in the grid, with precision hidden as it's a technical configuration detail. Currency records are referenced wherever monetary values need formatting or conversion.
Fields
Currency
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Currency name. |
symbol | text | Yes | Currency symbol. |
code | text | Yes | Currency code. |
precision | number | Yes | Currency precision. |
fx | number | Yes | Exchange rate. |
Relationships
- No declared relationships in the default definition.
Creating a Currency via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "CURRENCY",
"level": 250,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example name",
"symbol": "Example value",
"code": "Example value",
"precision": 0
}Listing Currencies records
GET /v1/entities/CURRENCY/SUB:<your-sub-id>