---
title: "List documents"
method: GET
path: "/v0/customers/{id}/kyc/documents"
tags: ["Customers"]
---

# List documents

`GET /v0/customers/{id}/kyc/documents`

## Request

- Base URL: `https://orchestration.seismic.systems/api`
- URL: `https://orchestration.seismic.systems/api/v0/customers/{id}/kyc/documents`
- Auth: API key in header `Api-Key`

## Path parameters

- `id` string, uuid, required

## Response `200`

Document metadata, discriminated on `type`.

- union
  - object
    - `documents` KycDocumentRef[], required
      - `content_type` string, required
      - `deleted_at` string, date-time, nullable: When the document was soft-deleted, if it has been. Only ever populated on the internal admin documents view; the partner list omits soft-deleted documents entirely, so this is always absent there.
      - `description` string, nullable: User-supplied label; only ever set for multi-instance `other` docs.
      - `document_id` string, uuid, required
      - `filename` string, required
      - `kind` string, required
      - `proof_of_address_type` 'utility_bill' | 'bank_statement' | 'rental_agreement' | 'tax_document' | 'government_correspondence': What a proof of address is. Declared with the upload, because each verification review files a proof of address under one of these and nothing else about the file says which.
      - `size_bytes` integer, required
      - `uploaded_at` string, date-time, required
    - `type` 'individual', required
  - object
    - `associated_persons` AssociatedPersonDocuments[], required: One entry per associated person on the profile, with that person's documents.
      - `documents` KybDocumentRef[], required: The person's documents, oldest first.
        - `content_type` string, required
        - `deleted_at` string, date-time, nullable: When the document was soft-deleted, if it has been. Only ever populated on the internal admin documents view; the partner list omits soft-deleted documents entirely, so this is always absent there.
        - `description` string, nullable: User-supplied label; only ever set for multi-instance `other` docs.
        - `document_id` string, uuid, required
        - `filename` string, required
        - `kind` 'business_formation' | 'articles_of_association' | 'memorandum_of_association' | 'dba_registration' | 'bank_statement' | 'ubo_bank_statement' | 'ownership_information' | 'shareholder_register' | 'certificate_of_incumbency' | 'flow_of_funds' | 'proof_of_nature_of_business' | 'compliance_screening' | 'government_issued_id' | 'passport' | 'drivers_licence_front' | 'drivers_licence_back' | 'identity_card_front' | 'identity_card_back' | 'selfie' | 'proof_of_address' | 'ubo_source_of_funds' | 'tax_document' | 'licensed_vendors_attestation' | 'proof_of_licensure' | 'proof_of_verification' | 'supplemental' | 'other', required
        - `proof_of_address_type` 'utility_bill' | 'bank_statement' | 'rental_agreement' | 'tax_document' | 'government_correspondence': What a proof of address is. Declared with the upload, because each verification review files a proof of address under one of these and nothing else about the file says which.
        - `size_bytes` integer, required
        - `uploaded_at` string, date-time, required
      - `person_id` string, uuid, required: The associated person's id, as on `profile.associated_persons[].id`.
    - `documents` KybDocumentRef[], required: The business's own documents.
      - `content_type` string, required
      - `deleted_at` string, date-time, nullable: When the document was soft-deleted, if it has been. Only ever populated on the internal admin documents view; the partner list omits soft-deleted documents entirely, so this is always absent there.
      - `description` string, nullable: User-supplied label; only ever set for multi-instance `other` docs.
      - `document_id` string, uuid, required
      - `filename` string, required
      - `kind` 'business_formation' | 'articles_of_association' | 'memorandum_of_association' | 'dba_registration' | 'bank_statement' | 'ubo_bank_statement' | 'ownership_information' | 'shareholder_register' | 'certificate_of_incumbency' | 'flow_of_funds' | 'proof_of_nature_of_business' | 'compliance_screening' | 'government_issued_id' | 'passport' | 'drivers_licence_front' | 'drivers_licence_back' | 'identity_card_front' | 'identity_card_back' | 'selfie' | 'proof_of_address' | 'ubo_source_of_funds' | 'tax_document' | 'licensed_vendors_attestation' | 'proof_of_licensure' | 'proof_of_verification' | 'supplemental' | 'other', required
      - `proof_of_address_type` 'utility_bill' | 'bank_statement' | 'rental_agreement' | 'tax_document' | 'government_correspondence': What a proof of address is. Declared with the upload, because each verification review files a proof of address under one of these and nothing else about the file says which.
      - `size_bytes` integer, required
      - `uploaded_at` string, date-time, required
    - `type` 'business', required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Customer not found.

---

[API](https://skmtc.dev/seismic/apis/seismic-orchestration-api.md) - [All operations](https://skmtc.dev/seismic/apis/seismic-orchestration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seismic/apis/seismic-orchestration-api/revisions/08ada1f159fa?raw)