---
title: "Get investor documents"
method: GET
path: "/v0/investor-documents"
tags: ["Investor Documents"]
---

# Get investor documents

`GET /v0/investor-documents`

## Request

- Base URL: `https://distributor-api.spiko.io`
- URL: `https://distributor-api.spiko.io/v0/investor-documents`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/spiko/apis/spiko-distributor-api/docs/v0/investor-documents/get.ts> (a function with typed inputs; its response is checked against the schema)

**Retrieve all documents for an investor.**

- Returns a list of documents uploaded for the specified investor.
- Only active (non-archived) documents are returned.
- Optionally filter by `documentTypes` (e.g. [`official-id`, `proof-of-address`, `imprime-fiscal-unique`]).

## Query parameters

- `investorId` string, uuid, required: a Universally Unique Identifier
- `documentTypes` string[]

## Response `200`

Success

- object[]
  - `id` string, uuid, required: a Universally Unique Identifier
  - `investorId` string, uuid, required: a Universally Unique Identifier
  - `documentType` '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' | 'imprime-fiscal-unique' | 'cash&carry-suitability-assessment' | 'cash&carry-appropriateness-assessment' | 'regulatory-information', required
  - `contentType` string, required
  - `s3FilePath` string, required
  - `originalFileName` string, required
  - `createdAt` string, required: A valid date within the range 2020-2100
  - `createdBy` union, required
    - object
      - `userId` string, uuid, required: a Universally Unique Identifier
      - `type` 'investor', required
    - object
      - `userId` string, uuid, required: a Universally Unique Identifier
      - `type` 'user', required
    - object
      - `userId` string, uuid, required: a Universally Unique Identifier
      - `type` 'admin', required
    - object
      - `userId` string, uuid, required: a Universally Unique Identifier
      - `type` 'distributor-client', required
    - object
      - `userId` string, uuid, required: a Universally Unique Identifier
      - `type` 'distributor-user', required
    - object
      - `type` 'system', required
  - `rejectionReason` string
  - `status` 'pending' | 'pending_review' | 'active' | 'rejected' | 'archived', required

## Other responses

- `400`: 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)