API Test Keys

Create a Stakeholder

POST

/v2/accounts/:account_id/stakeholders

Click to copy

Use this API endpoint to create a stakeholder. Know about the

various error responses

for this API.

Is this page helpful?

Curl

change language

1curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
2-X POST https://api.razorpay.com/v2/accounts/acc_GLGeLkU2JUeyDZ/stakeholders \
3-H "Content-Type: application/json" \
4-d '{
5  "percentage_ownership": 10,
6  "name": "Gaurav Kumar",
7  "email": "gaurav.kumar@example.com",
8  "relationship": {
9    "director": true,
10    "executive": false
11  },
12  "phone": {
13    "primary": "9000090000",
14    "secondary": "9000090000"
15  },
16  "addresses": {
17    "residential": {
18      "street": "506, Koramangala 1st block",
19      "city": "Bengaluru",
20      "state": "Karnataka",
21      "postal_code": "560034",
22      "country": "IN"
23    }
24  },
25  "kyc": {
26    "pan": "AVOPB1111K"
27  },
28  "notes": {
29    "random_key_by_partner": "random_value"
30  }
31}'

Success

1{
2  "entity": "stakeholder",
3  "relationship": {
4    "director": true
5  },
6  "phone": {
7    "primary": "9000090000",
8    "secondary": "9000090000"
9  },
10  "notes": {
11    "random_key_by_partner": "random_value"
12  },
13  "kyc": {
14    "pan": "AVOPB1111K"
15  },
16  "id": "sth_GLGgm8fFCKc92m",
17  "name": "Gaurav Kumar",
18  "email": "gaurav.kumar@example.com",
19  "percentage_ownership": 10,
20  "addresses": {
21    "residential": {
22      "street": "506, Koramangala 1st block",
23      "city": "Bengaluru",
24      "state": "Karnataka",
25      "postal_code": "560034",
26      "country": "IN"
27    }
28  }
29}

Path Parameters

account_id

string

The unique identifier of the sub-merchant account generated by Razorpay. For example, acc_GLGeLkU2JUeyDZ. This id is used to fetch or update a stakeholder. The stakeholder is created for this sub-merchant account id.

Request Parameters

name

string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email

string

The stakeholder's email address. The maximum length is:

local part (before @): 64 characters.
domain part (after @): 68 characters.
The total character length supported is 132.

percentage_ownership

float

The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, 87.55. The maximum length is 100 characters.

relationship

boolean

The stakeholder's relationship with the account’s business. The default value is false.

director: This attribute is set to true if the stakeholder is a director of the account's legal entity. By default, it is set to false.
executive: This attribute is set to true if the stakeholder is an executive of the account's legal entity. By default, it is set to false.

phone

object

The stakeholder's phone number.

Show child parameters (2)

addresses

object

Details of stakeholder's address.

Show child parameters (1)

kyc

object

The type of document required to establish the stakeholder's identity.

Show child parameters (1)

notes

object

Contains user-defined fields stored by the partner for reference purposes. Maximum 15 key-value pairs, 512 characters (maximum) each.

Response Parameters

id

string

The unique identifier of the stakeholder whose details are created. For example, sth_GLGgm8fFCKc92m.

percentage_ownership

float

The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, 87.55. The maximum length is 100 characters.

name

string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email

string

The stakeholder's email address. The maximum length is:

local part (before @): 64 characters.
domain part (after @): 68 characters.
The total character length supported is 132.

relationship

object

The stakeholder's relationship with the account’s business. The default value is false.

director: This attribute is set to true if the stakeholder is a director of the account's legal entity. By default, it is set to false.
executive: This attribute is set to true if the stakeholder is an executive of the account's legal entity. By default, it is set to false.

phone

object

The stakeholder's phone number.

Show child parameters (2)

addresses

object

Details of stakeholder's address.

Show child parameters (1)

kyc

object

The type of document required to establish the stakeholder's identity.

Show child parameters (1)

notes

object

Contains user-defined fields stored by the partner for reference purposes. It can hold a maximum of 15 key-value pairs, 512 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

Create a Stakeholder

POST

/v2/accounts/:account_id/stakeholders

Click to copy

Use this API endpoint to create a stakeholder. Know about the

various error responses

for this API.

Is this page helpful?

Path Parameters

account_id

string

Request Parameters

name

string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email

string

The stakeholder's email address. The maximum length is:

local part (before @): 64 characters.
domain part (after @): 68 characters.
The total character length supported is 132.

percentage_ownership

float

The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, 87.55. The maximum length is 100 characters.

relationship

boolean

The stakeholder's relationship with the account’s business. The default value is false.

director: This attribute is set to true if the stakeholder is a director of the account's legal entity. By default, it is set to false.
executive: This attribute is set to true if the stakeholder is an executive of the account's legal entity. By default, it is set to false.

phone

object

The stakeholder's phone number.

Show child parameters (2)

addresses

object

Details of stakeholder's address.

Show child parameters (1)

kyc

object

The type of document required to establish the stakeholder's identity.

Show child parameters (1)

notes

object

Contains user-defined fields stored by the partner for reference purposes. Maximum 15 key-value pairs, 512 characters (maximum) each.

Response Parameters

id

string

The unique identifier of the stakeholder whose details are created. For example, sth_GLGgm8fFCKc92m.

percentage_ownership

float

The stakeholder's ownership of the business in percentage. Only two decimal places are allowed. For example, 87.55. The maximum length is 100 characters.

name

string

The stakeholder's name as per the PAN card. The maximum length is 255 characters.

email

string

The stakeholder's email address. The maximum length is:

local part (before @): 64 characters.
domain part (after @): 68 characters.
The total character length supported is 132.

relationship

object

The stakeholder's relationship with the account’s business. The default value is false.

director: This attribute is set to true if the stakeholder is a director of the account's legal entity. By default, it is set to false.
executive: This attribute is set to true if the stakeholder is an executive of the account's legal entity. By default, it is set to false.

phone

object

The stakeholder's phone number.

Show child parameters (2)

addresses

object

Details of stakeholder's address.

Show child parameters (1)

kyc

object

The type of document required to establish the stakeholder's identity.

Show child parameters (1)

notes

object

Contains user-defined fields stored by the partner for reference purposes. It can hold a maximum of 15 key-value pairs, 512 characters (maximum) each. For example, "note_key": "Beam me up Scotty”.

Curl

change language

1curl -u <YOUR_KEY_ID>:<YOUR_KEY_SECRET> \
2-X POST https://api.razorpay.com/v2/accounts/acc_GLGeLkU2JUeyDZ/stakeholders \
3-H "Content-Type: application/json" \
4-d '{
5  "percentage_ownership": 10,
6  "name": "Gaurav Kumar",
7  "email": "gaurav.kumar@example.com",
8  "relationship": {
9    "director": true,
10    "executive": false
11  },
12  "phone": {
13    "primary": "9000090000",
14    "secondary": "9000090000"
15  },
16  "addresses": {
17    "residential": {
18      "street": "506, Koramangala 1st block",
19      "city": "Bengaluru",
20      "state": "Karnataka",
21      "postal_code": "560034",
22      "country": "IN"
23    }
24  },
25  "kyc": {
26    "pan": "AVOPB1111K"
27  },
28  "notes": {
29    "random_key_by_partner": "random_value"
30  }
31}'

Success

1{
2  "entity": "stakeholder",
3  "relationship": {
4    "director": true
5  },
6  "phone": {
7    "primary": "9000090000",
8    "secondary": "9000090000"
9  },
10  "notes": {
11    "random_key_by_partner": "random_value"
12  },
13  "kyc": {
14    "pan": "AVOPB1111K"
15  },
16  "id": "sth_GLGgm8fFCKc92m",
17  "name": "Gaurav Kumar",
18  "email": "gaurav.kumar@example.com",
19  "percentage_ownership": 10,
20  "addresses": {
21    "residential": {
22      "street": "506, Koramangala 1st block",
23      "city": "Bengaluru",
24      "state": "Karnataka",
25      "postal_code": "560034",
26      "country": "IN"
27    }
28  }
29}