--- title: "Upload investor document" method: POST path: "/v0/investor-documents" tags: ["Investor Documents"] --- # Upload investor document `POST /v0/investor-documents` ## Request - Base URL: `https://distributor-api.spiko.io` - URL: `https://distributor-api.spiko.io/v0/investor-documents` - Auth: HTTP basic - TypeScript: (a function with typed inputs; its response is checked against the schema) **Upload document (official ID / proof of address / screening report etc.) related to an investor.** - Supported extensions are: pdf, jpg, png, doc, docx, xls, xlsx. - Returns the ID of the created investor document. ## Request body `multipart/form-data` - object - `investorId` string, uuid, required: a Universally Unique Identifier - `type` 'proof-of-bank-account-ownership' | 'certificate-of-incorporation' | 'articles-of-association' | 'certificate-of-good-standing' | 'official-id' | 'proof-of-address' | 'proof-of-funds' | 'extract-of-ubo-register' | 'company-register-extract' | 'screening-report' | 'power-of-attorney' | 'other-document' | 'unknown', required - `file` string, binary, required ## Response `200` a Universally Unique Identifier - string, uuid: a Universally Unique Identifier ## Other responses - `400`: BadRequest | Application Error | The request did not match the expected schema - `401`: Authentication failed. Two bodies are possible: the schema below when the API rejects the credentials, and `{ "error": { "code", "status", "request", "message" } }` when the API gateway rejects them first. Only the former carries a `_tag`. - `403`: Forbidden - `404`: NotFound - `503`: The investor is undergoing a scheduled upgrade, access is temporarily paused to ensure data safety. --- [API](https://skmtc.dev/spiko/apis/spiko-distributor-api.md) - [All operations](https://skmtc.dev/spiko/apis/spiko-distributor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spiko/apis/spiko-distributor-api/revisions/ad85137fd00b?raw)