id as {incorporationId} for participant, document, intake, status, issue, and submit endpoints.
Attributes
| Attribute | Type | Description |
|---|---|---|
id | string | Unique incorporation identifier. Use this value as {incorporationId}. |
incorporationId | string | Stable incorporation identifier. Same value as id. |
customerId | integer | Customer that owns the incorporation. This is not the legal entity being incorporated. |
country | string | ISO 3166-1 alpha-2 jurisdiction code for the incorporation. |
countryOptions | object | Country-specific incorporation selections. The shape depends on country; use the jurisdiction catalog to discover supported keys and values. |
incorporationStatus | string | Top-level lifecycle status for the incorporation. |
businessEntityId | integer or null | Target Commenda OS business entity id for the entity being incorporated. Corporate shareholder business entity ids are separate participant resource ids. |
createdAt | string | ISO timestamp for when the incorporation was created. |
updatedAt | string | ISO timestamp for when the incorporation was last updated. |
Status values
| Value | Meaning |
|---|---|
awaiting_customer_input | Required intake information, participant roles, or documents are missing or invalid, or the current state is complete but has not been submitted for review. |
submitted | The incorporation was explicitly submitted and currently validates against the incorporation requirements, but workflow work has not started yet. |
in_progress | Commenda is actively processing the incorporation through the dedicated workflow. |
blocked | The incorporation has active partner-visible issues or workflow start/runtime failures. |
completed | The incorporation has been completed. |
Related response data
Some endpoints return the incorporation object inside a response wrapper with related data:| Field | Description |
|---|---|
requirements | Current incorporation requirements for the selected jurisdiction and options. |
incorporationValidation | Current validation result for the full incorporation. |
intakeState | Current submitted incorporation-level intake values. |
participants | Participants registered to this incorporation, when requested or available. |
Endpoints
| Action | Endpoint |
|---|---|
| Create | Create an incorporation |
| List | List incorporations |
| Retrieve | Get an incorporation |
| Submit | Submit an incorporation |
| Read status | Get incorporation status |
| Read issues | List incorporation issues |