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

# List customer KYB documents

> Returns every KYB document the business has registered for this customer. Each row's `url` is a 2-minute presigned link to the underlying file. The customer must be of type `business`. Required scope: `customer:read`.



## OpenAPI

````yaml /api-reference/customer/list-documents-openapi.json get /api/external/customer/{customer}/document
openapi: 3.1.0
info:
  title: Blaaiz Platform API - List Customer KYB Documents
  version: 1.0.0
  description: >-
    List the KYB document collection attached to a business-type customer
    (incorporation certificates, beneficial-ownership certificates, bank
    statements, proof of address, etc.). Each row carries a 2-minute presigned
    download URL. This endpoint applies to business-type customers only —
    individual customers continue to use the legacy file slots via POST
    /api/external/customer/{id}/files.
servers:
  - url: https://api-prod.blaaiz.com
  - url: https://api-dev.blaaiz.com
security: []
tags:
  - name: Customer
paths:
  /api/external/customer/{customer}/document:
    get:
      tags:
        - Customer
      summary: List customer KYB documents
      description: >-
        Returns every KYB document the business has registered for this
        customer. Each row's `url` is a 2-minute presigned link to the
        underlying file. The customer must be of type `business`. Required
        scope: `customer:read`.
      parameters:
        - name: customer
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Customer ID.
      responses:
        '200':
          description: List of customer KYB documents.
          content:
            application/json:
              example:
                data:
                  - id: 019a6e10-1fb3-7b2f-8f8b-ad1e92c4017a
                    business_customer_id: 019a6da3-4a9a-7033-81b9-12489eff13ee
                    type: CERTIFICATE_OF_INCORPORATION
                    name: Acme Inc — Certificate of Incorporation.pdf
                    extension: pdf
                    description: Filed 2019-03-12, Companies House
                    status: PROCESSING
                    admin_comments: null
                    url: https://s3.amazonaws.com/...?X-Amz-Signature=...
                    created_at: '2026-04-20T10:14:31.000000Z'
                    updated_at: '2026-04-20T10:14:31.000000Z'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Customer not found or does not belong to your business.
      security:
        - oauth2ClientCredentials:
            - customer:read
components:
  schemas:
    Error:
      type: object
      properties:
        status:
          type: boolean
        message:
          type: string
      required:
        - status
        - message
  securitySchemes:
    oauth2ClientCredentials:
      type: oauth2
      description: >-
        Use your OAuth client credentials to obtain a short-lived Bearer token
        from POST /oauth/token.
      flows:
        clientCredentials:
          tokenUrl: /oauth/token
          scopes:
            customer:read: Read customers.

````