> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Stakeholder Documents

> Upload signatory documents for a Stakeholder using Razorpay Curlec APIs.

Available in
🇮🇳 India
🇲🇾 Malaysia
🇺🇸 United States

Use this endpoint to upload signatory documents for a stakeholder. Know about the various error responses for this API.

> [!NOTE]
>
> **Handy Tips**
>
> If your product activation status is `requested`, you can update all the fields. If the status is `needs_clarification`, you can update only specific fields.

```bash Curl theme={null}
curl -X POST https://api.razorpay.com/v2/accounts/acc_Go5TSvGPw0NB8v/stakeholders/sth_Go5iFZJ8dqAfjg/documents \
-u <ACCESS_TOKEN> \
-F 'file=@/Users/your_name/Downloads/sample_uploaded.jpeg' // file path
-F 'document_type=aadhar_front' 
```

```java Java theme={null}
RazorpayClient razorpay = new RazorpayClient("[ACCESS_TOKEN]");

String accoundId = "acc_LryDIBIjBDbOWy";
String stakeholderId = "sth_M0zjeiVOLRJRPW";

JSONObject request = new JSONObject();
request.put("file","/Users/your_name/Downloads/sample_uploaded.jpeg");
request.put("document_type","aadhar_front");

Stakeholder stakeholder = instance.stakeholder.uploadStakeholderDoc(accoundId, stakeholderId, request);
```

```php PHP theme={null}
$api = new Api(null, null, "<ACCESS_TOKEN>");

$accountId = "acc_00000000000001";
$stakeholderId = "sth_00000000000001";
$payload = [
   'file'=> '/Users/your_name/Downloads/sample_uploaded.pdf',
   "document_type" => "aadhar_front"
];

$stakeholders = $api->account->fetch($accountId)->stakeholders();

$stakeholders->uploadStakeholderDoc($stakeholderId, $payload);
```

```javascript Node.js theme={null}
const instance = new Razorpay({
  oauthToken: "<ACCESS_TOKEN>",
});

const accountId = "acc_GP4lfNA0iIMn5B";
const stakeholderId = "sth_GOQ4Eftlz62TSL";

const uploadFile = fs.createReadStream(
  "/Users/your_name/Downloads/sample_uploaded.jpeg",
);

const formData = {
  file: {
    value: uploadFile,
    options: {
      filename: "sample_uploaded.jpeg",
      contentType: null,
    },
  },
  document_type: "aadhar_front",
};

instance.stakeholders.uploadStakeholderDoc(accountId, stakeholderId, formData);
```

```ruby Ruby theme={null}
require "razorpay"
Razorpay.setup('ACCESS_TOKEN')
account_id = "acc_0000000000001"
stakeholder_id = "sth_00000000000001"

Razorpay::Stakeholder.upload_stakeholder_doc(account_id, stakeholder_id, {
  "file": File.new("/Users/your_name/Downloads/sample_uploaded.jpeg"),
  "document_type": "aadhar_front"
});
```

```json Success theme={null}
{
  "individual_proof_of_address": [
    {
      "type": "aadhar_front",
      "url": "https://rzp.io/i/bzDAbNg"
    }
  ]
}
```

## Path Parameters

**account\_id** `string` *required*

The unique identifier of a sub-merchant account generated by Razorpay Curlec. For example, `acc_GMh5YcLv9iGMKf`.

**stakeholder\_id** `string` *required*

The unique identifier of the stakeholder generated by Razorpay Curlec. For example, `sth_GOUCFN3nE0XlYq`.

## Request Parameters

**file** `array` *required*

The URL generated once the business proof document is uploaded.

**document\_type** `string` *required*

The documents for the valid proof type to be shared. In case of `individual_proof_of_address`, both the front and back of a document proof must be uploaded. Possible values:

* individual\_proof\_of\_identification:\\

  * `personal_pan`\\

* individual\_proof\_of\_address:\\

  * `voter_id_back`\\

  * `voter_id_front`\\

  * `aadhar_front`\\

  * `aadhar_back`\\

  * `passport_front`\\

  * `passport_back`

## Response Parameters

**individual\_proof\_of\_address** `array`

The document submitted as individual proof of address.

**type** `string`

The type of document. Possible values:

* `voter_id_back`\\

* `voter_id_front`\\

* `aadhar_front`\\

* `aadhar_back`\\

* `passport_front`\\

* `passport_back`

**url** `string`

The URL of the document.
