---
title: "Upload a document for a shareholder. Requires multipart/form-data with fields: file (binary) and documentType (string)"
method: POST
path: "/api/v1/merchants/{merchantId}/shareholders/{shareholderId}/documents"
tags: ["Shareholder Documents"]
---

# Upload a document for a shareholder. Requires multipart/form-data with fields: file (binary) and documentType (string)

`POST /api/v1/merchants/{merchantId}/shareholders/{shareholderId}/documents`

Upload a document for a shareholder. Requires multipart/form-data with fields: file (binary) and documentType (string)

## Path parameters

- `merchantId` string, uuid, required — The unique identifier of the merchant
- `shareholderId` string, uuid, required — The unique identifier of the shareholder

## Response `201`

Created

- ShareholderDocumentUploadResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required — Shareholder document metadata
    - `id` string, uuid, required — Unique document ID
    - `documentType` 'PROOF_OF_ADDRESS', required — Valid document types for shareholder documents
    - `fileName` string, required — Original file name
    - `uploadedAt` string, date-time, required — Upload timestamp

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/versions/f86d2bdbcb08/schema)