Skip to main content
GET
/
partner
/
incorporation
/
{incorporationId}
/
status
Get incorporation status
curl --request GET \
  --url https://api.prod.commenda.io/api/v1/partner/incorporation/{incorporationId}/status \
  --header 'x-api-key: <api-key>'
{
  "incorporationStatus": "awaiting_customer_input",
  "incorporationId": "0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91",
  "companyId": 77,
  "country": "SG",
  "countryOptions": {
    "corporationType": "PRIVATE_LIMITED_COMPANY"
  },
  "statusWorkflow": {
    "schemaVersion": "2026-04-26",
    "definitionVersion": "1.0.0",
    "key": "singapore-incorporation-partner-api"
  },
  "blockingIssueIds": [
    "issue_123"
  ],
  "blockingIssueCount": 1,
  "stages": [
    {
      "id": "kyc",
      "label": "KYC",
      "description": "Review required identity, ownership, and compliance materials.",
      "owner": "partner",
      "position": 2,
      "status": "not_started",
      "startedAt": "2026-04-26T19:05:00.000Z",
      "completedAt": null,
      "blockedByIssueIds": [
        "issue_123"
      ]
    }
  ],
  "updatedAt": "2026-04-26T19:15:00.000Z"
}
Retrieves the current public status projection for an incorporation. Use this endpoint for progress views after an incorporation is created. It returns the top-level incorporationStatus, the workflow version used for the case, ordered stages, and any active issues blocking the case.

​
Example

curl --request GET \
  --url 'https://api.prod.commenda.io/api/v1/partner/incorporation/0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91/status' \
  --header 'x-api-key: <partner_api_key>'

{
  "incorporationStatus": "blocked",
  "incorporationId": "0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91",
  "companyId": 77,
  "country": "SG",
  "countryOptions": {
    "corporationType": "PRIVATE_LIMITED_COMPANY"
  },
  "statusWorkflow": {
    "schemaVersion": "2026-04-26",
    "definitionVersion": "1.0.0",
    "key": "singapore-incorporation-partner-api"
  },
  "blockingIssueIds": ["issue_123"],
  "blockingIssueCount": 1,
  "stages": [
    {
      "id": "intake",
      "label": "Intake",
      "description": "Collect required incorporation information and documents.",
      "owner": "partner",
      "position": 1,
      "status": "completed",
      "startedAt": "2026-04-26T18:10:00.000Z",
      "completedAt": "2026-04-26T18:30:00.000Z",
      "blockedByIssueIds": []
    },
    {
      "id": "kyc",
      "label": "KYC",
      "description": "Review required identity, ownership, and compliance materials.",
      "owner": "commenda",
      "position": 2,
      "status": "blocked",
      "startedAt": "2026-04-26T19:05:00.000Z",
      "completedAt": null,
      "blockedByIssueIds": ["issue_123"]
    }
  ],
  "updatedAt": "2026-04-26T19:15:00.000Z"
}

​
Top-level status

StatusMeaning
awaiting_customer_inputRequired intake information, participant roles, or documents are missing or invalid, or the complete intake has not been submitted yet.
submittedThe incorporation was submitted and still validates, but workflow work has not started yet.
in_progressCommenda is processing the incorporation through the dedicated workflow.
blockedThe incorporation has active partner-visible issues or workflow start/runtime failures.
completedThe incorporation is complete.

​
Stage status

StatusMeaning
not_startedThe stage has not started.
in_progressAt least one task in the stage has started and the stage is not complete.
blockedThe stage is blocked by active issue ids or failed workflow work.
completedThe stage is complete.
Active issues are listed in blockingIssueIds. If an issue has a scope.stageId, that issue appears on the matching stage’s blockedByIssueIds; otherwise it blocks the first non-completed stage.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
incorporationId
string
required

Incorporation identifier returned by create or list endpoints.

Response

Incorporation status retrieved successfully

​
incorporationStatus
enum<string>
required

Current top-level lifecycle status for the incorporation.

Available options:
awaiting_customer_input,
submitted,
in_progress,
blocked,
completed
​
incorporationId
string
required
Example:

"0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91"

​
companyId
integer
required
Example:

77

​
country
enum<string>
required

ISO 3166-1 alpha-2 country code for the incorporation jurisdiction.

Available options:
AE,
CA,
GB,
IE,
IN,
KY,
NZ,
SG,
US
Example:

"SG"

​
countryOptions
object
required

Country-specific incorporation options. Use the jurisdiction catalog for the currently supported fields and values.

Example:
{
  "corporationType": "PRIVATE_LIMITED_COMPANY"
}
​
statusWorkflow
object
required
​
blockingIssueIds
string[]
required

Active partner-visible issue ids currently blocking the incorporation.

Example:
["issue_123"]
​
blockingIssueCount
integer
required
Example:

1

​
stages
object[]
required
​
updatedAt
string<date-time>
required
Example:

"2026-04-26T19:15:00.000Z"