Skip to main content
GET
/
partner
/
incorporation
/
jurisdiction-catalog
List supported incorporation jurisdictions
curl --request GET \
  --url https://api.prod.commenda.io/api/v1/partner/incorporation/jurisdiction-catalog \
  --header 'x-api-key: <api-key>'
{
  "countries": [
    {
      "country": "SG",
      "fields": [
        {
          "key": "corporationType",
          "type": "select",
          "required": true,
          "options": [
            "CORPORATION",
            "LLC"
          ]
        }
      ]
    }
  ]
}
Returns the currently supported incorporation countries and country-specific option fields. Use this endpoint as an informational catalog for rendering choices in your UI. The create incorporation endpoint remains the source of truth for validation. Field keys map directly to paths inside countryOptions. Simple keys become direct properties, such as countryOptions.corporationType. Dotted keys, such as corporationTypeOptions.freeZone, represent nested objects inside countryOptions.

​
Supported countries

The catalog currently includes AE, CA, GB, IE, IN, KY, NZ, SG, and US.

​
Field format

Each country returns a list of fields: 
{
  "country": "US",
  "fields": [
    {
      "key": "state",
      "type": "select",
      "required": false,
      "options": ["AL", "AK", "AZ"]
    },
    {
      "key": "corporationType",
      "type": "select",
      "required": true,
      "options": ["CORPORATION", "LLC"]
    }
  ]
}
Use key as the path inside countryOptions. For example, corporationTypeOptions.freeZone should be sent as: 
{
  "countryOptions": {
    "corporationTypeOptions": {
      "freeZone": "DMCC"
    }
  }
}
For Singapore private limited companies, the catalog returns a simple corporationType field: 
{
  "country": "SG",
  "fields": [
    {
      "key": "corporationType",
      "type": "select",
      "required": true,
      "options": ["PRIVATE_LIMITED_COMPANY"]
    }
  ]
}
Send that selection in countryOptions as: 
{
  "country": "SG",
  "countryOptions": {
    "corporationType": "PRIVATE_LIMITED_COMPANY"
  }
}
For GET endpoints that use query parameters, send the same shape with deep-object query syntax: 
GET /partner/incorporation/requirements?country=SG&countryOptions[corporationType]=PRIVATE_LIMITED_COMPANY
This endpoint is informational only. It is safe to use for UI rendering, but clients should still handle validation errors from POST /partner/incorporation/customers/{customerId}/incorporations.

Authorizations

​
x-api-key
string
header
required

Response

Jurisdiction catalog retrieved successfully

​
countries
object[]
required