> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commenda.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Incorporation object

> Field reference for the top-level Partner Incorporation API record.

The incorporation object represents one customer incorporation. Create it after the customer chooses a jurisdiction and incorporation type, then use its `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}`.                                                                                   |
| `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. Always returned; an empty intake state is initialized automatically when one does not yet exist. |
| `participants`            | Participants registered to this incorporation, when requested or available.                                                                           |

## Endpoints

| Action      | Endpoint                                                                                   |
| ----------- | ------------------------------------------------------------------------------------------ |
| Create      | [Create an incorporation](/engine/incorporation/partner-incorporation-incorporations-POST) |
| List        | [List incorporations](/engine/incorporation/partner-incorporation-incorporations-GET)      |
| Retrieve    | [Get an incorporation](/engine/incorporation/partner-incorporation-incorporations-id-GET)  |
| Submit      | [Submit an incorporation](/engine/incorporation/partner-incorporation-submit-POST)         |
| Read status | [Get incorporation status](/engine/incorporation/partner-incorporation-status-GET)         |
| Read issues | [List incorporation issues](/engine/incorporation/partner-incorporation-issues-GET)        |