POST
/
incorporation-requests
/
{id}
/
submit
Submit incorporation request
curl --request POST \
  --url http://staging.api.commenda.io/api/v1/incorporation-requests/{id}/submit \
  --header 'Authorization: Bearer <token>'
{
  "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"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

The unique identifier of the incorporation request to submit.

Response

Successfully updated corporation details.

​
id
string

Unique identifier for this incorporation request.

​
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.

​
status
enum<string>
Available options:
NotSubmitted,
InProgress,
NeedsAdditionalInfo,
Succeeded,
Failed
​
signedFormUrl
string

A signed URL that customers can visit to upload their incorporation information. Valid for 24 hours.

Example:

"https://app.commenda.io/incorporate/us/bf98ab92-4271-4ce8-a77a-742abefad853?key=1MO/rp2/LekU9aI3dNW5nj19U+VLw7PF1GOo5unzyR4"