GET
/
key-persons
curl --request GET \
  --url http://staging.api.commenda.io/api/v1/key-persons \
  --header 'Authorization: Bearer <token>'
[
  {
    "firstName": "Bill",
    "lastName": "Lumbergh",
    "phoneNumber": "+13021234567",
    "email": "yaacov@commenda.io",
    "countryOfNationality": "US",
    "countryOfResidence": "US",
    "dateOfBirth": "1995-10-22",
    "countrySpecificInfo": {
      "IN": {
        "addressProofFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "aadharCardFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "panCardFileId": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "hasDigitalSignatureCertificate": true,
        "hasDirectorIdNumber": true,
        "directorIdNumber": "12345678"
      }
    }
  }
]

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
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 key persons.
​
firstName
string

The first name of the key person.

Example:

"Bill"

​
lastName
string

The last name of the key person.

Example:

"Lumbergh"

​
phoneNumber
string

Phone number in E.164 format.

Example:

"+13021234567"

​
email
string

Email address of the key person.

Example:

"yaacov@commenda.io"

​
countryOfNationality
string

Country of citizenship.

Example:

"US"

​
countryOfResidence
string

Country of tax residence.

Example:

"US"

​
dateOfBirth
string

Date of birth in ISO-8601 format.

Example:

"1995-10-22"

​
countrySpecificInfo
object

Information about the key person required by a specific incorporation jurisdiction.