ENT: Legal Entity
A legal entity (company) at the top of the org hierarchy with business units, financials, and registration details.
ENT 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 ENT.Entity properties
| Property | Value |
|---|---|
| Entity code | ENT |
| Display name | Legal Entity |
| Plural | Legal Entities |
| Level | 1000 |
Use cases
ENT is the root of the organisational hierarchy: ENT > BU > DIV > DEPT > DEPTSTF. It represents a legally registered company or organisation with registration number, tax ID, and country of incorporation. Business units (BU) are linked via comboKey SUB|ENT|ENT (the double ENT reflects the subscription + entity scoping). The financial section captures base currency (CURRENCY lookup), fiscal year dates, and serves as the financial reporting root. The entityType links to COMPOWN for company ownership classification. AI features (ai:true, context.getLegalEntityData) enable intelligent analysis across the entity's structure. Unlike LENTITY (which is a simple lookup), ENT is a full complex-view entity with structure navigation, financial configuration, and the ability to drill down into business units. The comboFilterAdd on PORT (SUB|ENT|BU|DIV|DEPT) enables portfolios to be scoped to any level of this hierarchy.
Fields
Basic Info
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Entity Name. |
shortName | text | Short Name. | |
code | text | Entity Code. | |
entityType | reference → COMPOWN | Type. | |
registrationNumber | text | Registration No.. | |
taxNumber | text | Tax ID / VAT No.. |
Location & Contact
| Field | Type | Required | Notes |
|---|---|---|---|
country | reference → COUNTRY | Yes | Country. |
address | text (multi-line) | Registered Address. | |
website | text (URL) | Website. | |
contactPerson | text | Primary Contact. | |
contactEmail | text | Contact Email. |
Key Financials
| Field | Type | Required | Notes |
|---|---|---|---|
currency | reference → CURRENCY | Yes | Base Currency. |
fiscalYearStart | date | Fiscal Year Start. | |
fiscalYearEnd | date | Fiscal Year End. |
Relationships
- Lookup:
entityType(reference →COMPOWN). - Lookup:
country(reference →COUNTRY). - Lookup:
currency(reference →CURRENCY). - Related list:
BU, comboKey formatSUB|ENT|ENT.
Creating a Legal Entity via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "ENT",
"level": 1000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Example name",
"country": "",
"currency": "",
"shortName": "Example value"
} Listing Legal Entities records
GET /v1/entities/ENT/SUB:<your-sub-id>