Entity pillar · v0.7.1
entity Entity
Company profile aligned with schema.org Organization and GLEIF LEI reference data.
$id · https://corpospec.com/schemas/v0.7.1/entity.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| functional_currency | IsoCurrency | yes | Functional (reporting) currency of the entity. ISO 4217. Canonical default for any monetary value elsewhere in the corpus that does not carry its own currency declaration. |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| jurisdiction | IsoCountry | yes | ISO 3166-1 alpha-2 country code. |
| legal_name | string | yes | |
| status | StatusActive | yes | Lifecycle status for entities. |
| type | EntityType | yes | Entity type discriminator. |
| address | PostalAddress? | — | |
| company_purpose | string? | — | |
| contact | Contact? | — | |
| custom | EntityCustom? | — | |
| date_of_incorporation | IsoDate? | — | |
| founders | PathRef[] | — | |
| legal_form | string? | — | |
| lei | Lei? | — | |
| number_of_employees | EmployeeCount? | — | |
| parent_organization | PathRef? | — | |
| registered_seat | string? | — | |
| registration_authority | string? | — | |
| registration_number | string? | — | |
| subsidiaries | PathRef[] | — | |
| tax_ids | TaxId[] | — | |
| trade_name | string? | — | |
| url | string? | — |
Definitions
Shared types referenced within this schema.
AccidentInsurance
Accident insurance registration (VBG).
type: object
BankingInfo
Banking information.
type: object
CapitalFlow
Capital flow between entities.
type: object
Contact
Contact information.
type: object
EmployeeCount
Employee count snapshot.
type: object
EntityCustom
Typed extension fields for Entity.
Union of all jurisdiction-specific fields observed in .corpospec/ YAML data.
type: object
EntityType
Entity type discriminator.
enum: "corporation", "llc", "partnership", "sole-proprietorship", "non-profit", "cooperative", "trust", "foundation", "lp", "llp", "joint-venture", "association", "reit", "pbc"
IncorporationTimeline
Incorporation timeline targets.
type: object
IsoCountry
ISO 3166-1 alpha-2 country code.
pattern: ^[A-Z]{2}$
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
LaborRegistration
Labor registration details (German Betriebsnummer).
type: object
Lei
ISO 17442 Legal Entity Identifier (20-character alphanumeric).
pattern: ^[A-Z0-9]{18}[0-9]{2}$
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
PlannedSubsidiary
Planned subsidiary entity.
type: object
PostalAddress
Physical address aligned with schema.org PostalAddress.
type: object
ReorganizationPlan
Corporate reorganization plan.
type: object
StatusActive
Lifecycle status for entities.
enum: "active", "inactive", "dissolved", "pre-incorporation", "planned"
TaxId
Tax identification number with type discriminator.
type: object
TaxStructure
Tax structure configuration.
type: object
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.7.1/entity.schema.json