GET
/
corporations
curl --request GET \
  --url http://staging.api.commenda.io/api/v1/corporations \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "legalName": "Initech Pvt. Ltd.",
    "registeredAddress": {
      "line1": "<string>",
      "line2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "postalCode": "<string>",
      "country": "US"
    },
    "formationCountry": "US",
    "uniqueIdentifierFromJurisdiction": "1234567",
    "taxId": "12-3456789",
    "countrySpecificInfo": {
      "US": {
        "formationState": "DE",
        "entityType": "CCorp",
        "EIN": "10-1234567"
      },
      "IN": {
        "formationState": "KA",
        "entityType": "PvtLtd",
        "PAN": "AAAPA1234A"
      },
      "CorporationDocuments": [
        {
          "type": "ArticlesOfAssociation",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ]
    }
  }
]

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
companyId
string
required

The unique identifier of the company whose corporations you want to retrieve.

​
cursor
string

Pagination cursor for the next set of results. Optional.

​
limit
integer
default:10

Number of items to return per page. Optional. Default is 10.

Required range: 1 <= x <= 100

Response

200
application/json
A list of corporations associated with the specified company ID
​
id
string

Unique identifier for this company.

​
legalName
string

The corporation's name, including its suffix.

Example:

"Initech Pvt. Ltd."

​
registeredAddress
object

Address registered with the incorporation jurisdiction

​
formationCountry
string

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

Example:

"US"

​
uniqueIdentifierFromJurisdiction
string

Unique ID for the entity in its jurisdiction of incorporation. Corporation Entity Number in Delaware, Company Registration Number in UK, etc.

Example:

"1234567"

​
taxId
string

Tax ID for the entity in its country of incorporation. EIN in the US, PAN in India, etc.

Example:

"12-3456789"

​
countrySpecificInfo
object

Information about the corporation that varies from country to country. Exactly one of these will be set, matching the incorporation country.