Skip to main content
GET
/
partner
/
incorporation
/
customers
/
{customerId}
/
incorporations
List incorporations for a customer
curl --request GET \
  --url https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations \
  --header 'x-api-key: <api-key>'
{
  "incorporations": [
    {
      "id": "0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91",
      "customerId": 77,
      "country": "SG",
      "countryOptions": {
        "corporationType": "PRIVATE_LIMITED_COMPANY"
      },
      "createdAt": "2026-04-21T17:10:00.000Z",
      "updatedAt": "2026-04-21T17:10:00.000Z",
      "businessEntityId": 44
    }
  ],
  "count": 1
}
Lists incorporations for one of your customers. 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 incorporation requirements, but Commenda review has not started yet.
IN_PROGRESSCommenda review is in progress.
BLOCKEDThe incorporation has active partner-visible issues or review start/runtime failures.
COMPLETEDThe incorporation has been completed.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
customerId
integer
required

Customer 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