List incorporations for a customer
curl --request GET \
--url https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations \
--header 'x-api-key: <api-key>'import requests
url = "https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"incorporations": [
{
"id": "0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91",
"customerId": 77,
"country": "SG",
"countryOptions": {
"corporationType": "PRIVATE_LIMITED_COMPANY"
},
"createdAt": "2026-04-21T17:10:00.000Z",
"updatedAt": "2026-04-21T17:10:00.000Z",
"businessEntityId": 44
}
],
"count": 1
}{
"statusCode": 403,
"message": "Company does not belong to this affiliate firm",
"error": "Forbidden"
}{
"statusCode": 403,
"message": "Company does not belong to this affiliate firm",
"error": "Forbidden"
}{
"statusCode": 403,
"message": "Company does not belong to this affiliate firm",
"error": "Forbidden"
}Incorporations
List incorporations
List incorporations visible to the authenticated partner for a single customer.
GET
/
partner
/
incorporation
/
customers
/
{customerId}
/
incorporations
List incorporations for a customer
curl --request GET \
--url https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations \
--header 'x-api-key: <api-key>'import requests
url = "https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.prod.commenda.io/api/v1/partner/incorporation/customers/{customerId}/incorporations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"incorporations": [
{
"id": "0f9a8f5e-7f7c-4c1b-a60a-b1022f9d8c91",
"customerId": 77,
"country": "SG",
"countryOptions": {
"corporationType": "PRIVATE_LIMITED_COMPANY"
},
"createdAt": "2026-04-21T17:10:00.000Z",
"updatedAt": "2026-04-21T17:10:00.000Z",
"businessEntityId": 44
}
],
"count": 1
}{
"statusCode": 403,
"message": "Company does not belong to this affiliate firm",
"error": "Forbidden"
}{
"statusCode": 403,
"message": "Company does not belong to this affiliate firm",
"error": "Forbidden"
}{
"statusCode": 403,
"message": "Company does not belong to this affiliate firm",
"error": "Forbidden"
}Lists incorporations for one of your customers.
Use
limit and offset for pagination. The count field is the total number of matching incorporations before pagination.
Incorporation status
Each returned incorporation includesincorporationStatus:
| Status | Meaning |
|---|---|
AWAITING_CUSTOMER_INPUT | Required intake information, participant roles, or documents are still missing or invalid, or the current state is complete but has not been submitted for review. |
SUBMITTED | The incorporation was explicitly submitted and currently validates against the incorporation requirements, but Commenda review has not started yet. |
IN_PROGRESS | Commenda review is in progress. |
BLOCKED | The incorporation has active partner-visible issues or review start/runtime failures. |
COMPLETED | The incorporation has been completed. |
Authorizations
Path Parameters
Customer whose incorporations should be listed.
Query Parameters
Maximum number of incorporations to return.
Required range:
1 <= x <= 100Number of matching incorporations to skip.
Required range:
x >= 0Was this page helpful?
⌘I