POST
/
incorporation-requests
/
{id}
curl --request POST \
  --url http://staging.api.commenda.io/api/v1/incorporation-requests/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "corporationDetails": {
    "US": {
      "CCorp": {
        "corporationName": "Commenda Technologies Inc.",
        "website": "<string>",
        "descriptionOfBusiness": "<string>",
        "fiscalYearEndDate": "2023-12-25",
        "physicalAddress": {
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postalCode": "<string>",
          "country": "US"
        },
        "mailingAddress": {
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postalCode": "<string>",
          "country": "US"
        },
        "authorizedShares": {
          "shareCount": 10000000,
          "sharesRetainedForESOPPool": 2000000,
          "shareValuation": 0.00001
        },
        "keyPersons": [
          {
            "keyPersonId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
            "isDirector": true,
            "isAuthorizedSignatory": true,
            "boardAppointedRoles": [
              "President"
            ],
            "sharesToIssue": 10000
          }
        ]
      },
      "LLC": {
        "llcName": "Commenda Technologies LLC.",
        "website": "<string>",
        "descriptionOfBusiness": "<string>",
        "fiscalYearEndDate": "2023-12-25",
        "physicalAddress": {
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postalCode": "<string>",
          "country": "US"
        },
        "mailingAddress": {
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postalCode": "<string>",
          "country": "US"
        },
        "keyPersons": [
          {
            "keyPersonId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
            "isAuthorizedSignatory": true,
            "membershipInterestAllocation": 123
          }
        ]
      }
    },
    "IN": {
      "PvtLtd": {
        "corporationName": "Commenda Technologies Pvt. Ltd.",
        "website": "<string>",
        "physicalAddress": {
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postalCode": "<string>",
          "country": "US"
        },
        "addressProofFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "keyPersons": [
          {
            "keyPersonId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
            "isDirector": true,
            "isAuthorizedSignatory": true,
            "boardAppointedRoles": [
              "President"
            ],
            "sharesToIssue": 10000
          }
        ]
      },
      "LLP": {
        "corporationName": "Commenda Technologies Inc.",
        "website": "<string>",
        "descriptionOfBusiness": "<string>",
        "capitalContribution": 123,
        "addressProofFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "keyPersons": [
          {
            "keyPersonId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
            "isAuthorizedSignatory": true,
            "capitalContribution": 123
          }
        ]
      }
    }
  }
}'
{
  "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 delete.

Body

application/json
corporationDetails
object
required

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

Response

200 - application/json
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"