Skip to main content
Use this page to understand the main objects before you start wiring endpoints together.

​
Object model

ConceptWhat it meansMain ID
Customer/company containerThe account-level customer record that owns the work. It is not the legal entity being incorporated.companyId
Incorporation caseThe incorporation workflow for one customer/company container and selected jurisdiction/type.incorporation.id
Commenda OS reusable resourceCustomer data that can be reused across workflows, such as people, business entities, locations, and files.Resource-specific IDs
ParticipantAn incorporation-specific registration of a reusable person or business entity, with roles such as director or shareholder.participantId
IntakeIncorporation-level requirement values that are not participant registrations or document links, such as company name options and registered office address choice.intakeState
Status and issuesPost-submit progress and partner-visible correction requests.incorporationStatus, issue.id
Customer/company container
  -> Incorporation case
       -> Participants
            -> Commenda OS people/business entities
            -> Participant documents
       -> Intake fields
       -> Status and issues

​
Reusable records vs incorporation-specific records

The Incorporation API does not duplicate people, business entities, locations, or files. Those records live in Commenda OS so they can be reused across KYC, entity management, registrations, documents, and future workflows. The Incorporation API links those reusable records into a specific incorporation case.
NeedCreate or read inLink through
Director or shareholder personCommenda OS PersonsIncorporation Participants
Corporate shareholderCommenda OS Business EntitiesIncorporation Participants
Registered office locationCommenda OS LocationsIntake registeredOfficeAddressLocation
Passport, utility bill, or other source fileCommenda OS DocumentsIncorporation Files, then Participant Documents

​
API surfaces

API surfaceUse it for
Customer container setupCreate or list the customer/company container that scopes later calls.
Partner Incorporation APIDiscover requirements, create incorporation cases, register participants, link documents, submit intake, track status, and read issues.
Commenda OS Partner APIManage reusable customer data such as people, business entities, locations, documents, government identifiers, and registrations.
Partner webhooksSubscribe to partner events such as incorporation issue creation and resolution.