Skip to main content
GET
/
partner
/
incorporation
/
companies
/
{companyId}
/
incorporations
List incorporations for a company
curl --request GET \
  --url https://api.prod.commenda.io/api/v1/partner/incorporation/companies/{companyId}/incorporations \
  --header 'x-api-key: <api-key>'
{
  "incorporations": [
    {
      "id": "0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91",
      "incorporationId": "0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91",
      "companyId": 77,
      "country": "SG",
      "countryOptions": {
        "corporationType": "PRIVATE_LIMITED_COMPANY"
      },
      "incorporationStatus": "awaiting_customer_input",
      "createdAt": "2026-04-21T17:10:00.000Z",
      "updatedAt": "2026-04-21T17:10:00.000Z",
      "corporationId": 44
    }
  ],
  "count": 1
}
Lists incorporations for a company accessible to your partner account. Use limit and offset for pagination. The count field is the total number of matching incorporations before pagination.

​
Incorporation status

Each returned incorporation includes incorporationStatus:
StatusMeaning
awaiting_customer_inputRequired intake information, participant roles, or documents are still missing or invalid, or the current state is complete but has not been submitted for review.
submittedThe incorporation was explicitly submitted and currently validates against the requirements DSL, but workflow work has not started yet.
in_progressCommenda is actively processing the incorporation through the dedicated workflow.
blockedThe incorporation has active partner-visible issues or workflow start/runtime failures.
completedThe incorporation has been completed.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
companyId
integer
required

Company whose incorporations should be listed.

Query Parameters

​
limit
integer

Maximum number of incorporations to return.

Required range: 1 <= x <= 100
​
offset
integer

Number of matching incorporations to skip.

Required range: x >= 0

Response

Incorporations retrieved successfully

​
incorporations
object[]
required
​
count
integer
required

Total matching incorporations before pagination.

Example:

1