Skip to main content
POST
/
public
/
services
Create an incorporation service for a company
curl --request POST \
  --url https://api.prod.commenda.io/api/v1/public/services \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "companyId": 77
}
'
{
  "paymentIntentId": "pi_123"
}
Creates a supported incorporation service for an affiliate-owned company and returns the paymentIntentId used by the current public handoff flow.

​
Supported service types

Only the following serviceType values are accepted:
Service typeDescription
US_CCORP_INCORPORATIONUnited States C-Corporation
US_LLC_INCORPORATIONUnited States LLC
CA_CORP_INCORPORATIONCanada Corporation
INDIA_PVT_LTD_INCORPORATIONIndia Private Limited
INDIA_LLP_INCORPORATIONIndia LLP
UAE_INCORPORATIONUnited Arab Emirates
UK_INCORPORATIONUnited Kingdom
IE_INCORPORATIONIreland
SG_INCORPORATIONSingapore
Requests with an unsupported serviceType return 400 Bad Request with a message listing the valid options.
Example error response
{
  "statusCode": 400,
  "message": [
    "serviceType must be one of the supported legacy affiliate API services: US_CCORP_INCORPORATION, US_LLC_INCORPORATION, CA_CORP_INCORPORATION, INDIA_PVT_LTD_INCORPORATION, INDIA_LLP_INCORPORATION, UAE_INCORPORATION, UK_INCORPORATION, IE_INCORPORATION, SG_INCORPORATION"
  ],
  "error": "Bad Request"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
companyId
integer
required

Company that the new incorporation service should be attached to.

Example:

77

​
serviceType
enum<string>
required

Incorporation service types currently supported by the legacy affiliate API.

Available options:
US_CCORP_INCORPORATION,
US_LLC_INCORPORATION,
CA_CORP_INCORPORATION,
INDIA_PVT_LTD_INCORPORATION,
INDIA_LLP_INCORPORATION,
UAE_INCORPORATION,
UK_INCORPORATION,
IE_INCORPORATION,
SG_INCORPORATION

Response

Service and payment intent created successfully

​
paymentIntentId
string
required

Identifier for the newly created payment intent that anchors the current public flow.

Example:

"pi_123"