Skip to main content
The jurisdiction catalog is the first step in an incorporation flow. It tells your integration which countries are currently supported and which country-specific options the customer must choose before you can fetch requirements or create an incorporation. Use it to render the customer’s initial choice of jurisdiction and entity type.

​
What the catalog answers

QuestionCatalog fieldHow to use it
Which countries can my customer incorporate in?countries[].countryShow available country choices.
Which country-specific options are needed?countries[].fieldsRender the option fields for the selected country.
Which values are accepted?fields[].optionsRestrict selections to the returned values.
How do I send the selected options?fields[].keyBuild the countryOptions object using each field key.

​
Country options

Each field key maps to a path inside countryOptions. Simple keys become direct properties: 
{
  "country": "SG",
  "countryOptions": {
    "corporationType": "PRIVATE_LIMITED_COMPANY"
  }
}
Dotted keys represent nested objects: 
{
  "countryOptions": {
    "corporationTypeOptions": {
      "freeZone": "DMCC"
    }
  }
}
For GET endpoints, send the same shape with deep-object query syntax: 
GET /partner/incorporation/requirements?country=SG&countryOptions[corporationType]=PRIVATE_LIMITED_COMPANY

​
When to refetch

The catalog is informational and may change as Commenda adds jurisdictions or supported entity types. You can cache it for UI rendering, but your integration should still handle validation errors from create and requirements endpoints. After the customer selects country and countryOptions, use that selection to fetch:
Next stepEndpoint
Required fields, participants, and documentsGET /partner/incorporation/requirements
Public progress stagesGET /partner/incorporation/status-workflow
New incorporationPOST /partner/incorporation/customers/{customerId}/incorporations