Skip to main content
POST
/
incorporation-requests
Request a new incorporation over the Commenda API
curl --request POST \
  --url http://staging.api.commenda.io/api/v1/incorporation-requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "country": "US",
  "corporationTypeInfo": {
    "US": {
      "state": "DE",
      "corporationType": "CCorp"
    },
    "IN": {
      "state": "KA",
      "corporationType": "PvtLtd"
    }
  }
}'
{
  "data": {
    "id": "<string>",
    "country": "US",
    "corporationTypeInfo": {
      "US": {
        "state": "DE",
        "corporationType": "CCorp"
      },
      "IN": {
        "state": "KA",
        "corporationType": "PvtLtd"
      }
    },
    "status": "NotSubmitted",
    "signedFormUrl": "https://app.commenda.io/incorporate/us/bf98ab92-4271-4ce8-a77a-742abefad853?key=1MO/rp2/LekU9aI3dNW5nj19U+VLw7PF1GOo5unzyR4"
  },
  "message": "Successfully created incorporation request."
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
companyId
string<uuid>

Unique identifier for a company.

​
country
string

ISO 3166 2-letter country code. Ex: US, IN, GB.

Example:

"US"

​
corporationTypeInfo
object

Exactly one of these fields should be set, matching the selected incorporation country. More options coming soon.

Response

Incorporation request created successfully

​
data
object
​
message
string
Example:

"Successfully created incorporation request."