Skip to main content

​
Object model

ConceptWhat it meansMain ID
CustomerOne of your customers. Every resource in the incorporation API is scoped to a specific customer.customerId
IncorporationA specific incorporation workflow, including selected jurisdiction/entity 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
ParticipantA reference to a person or business entity in Commenda OS, attached to this incorporation with a role such as DIRECTOR or SHAREHOLDER.participant.id
IntakeA collection of user-provided information about the entity being incorporated, 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
  -> Incorporation
       -> Participants
            -> Commenda OS people/business entities
            -> Participant documents
       -> Intake fields
       -> Status and issues

​
Reusable records vs incorporation-specific records

People, business entities, locations, and files live in Commenda OS so customers can reuse them across KYC, entity management, registrations, and documents. The Incorporation API links those reusable records to a specific incorporation.
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 FilesParticipant document upsert

​
Which API to call

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