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

# Lister les documents d'un dossier

> Toutes les pièces déjà attachées à un dossier KYC

<Note>
  Sur un dossier n'appartenant pas à votre marchand, cet endpoint renvoie `200` avec une liste **vide** plutôt qu'un `404` (contrairement au `POST` sur ce même chemin, qui lui renvoie bien `404`). Ne vous fiez pas à une liste vide pour conclure qu'un dossier n'existe pas.
</Note>


## OpenAPI

````yaml api-reference/openapi.json GET /merchant-kyc/{kyc_id}/documents/
openapi: 3.1.0
info:
  title: SasPay API
  description: >-
    API d'encaissement et de paiement mobile money/carte pour l'Afrique de
    l'Ouest et du Centre. Toutes les routes marchand nécessitent une clé API
    secrète (header Authorization: Bearer sk_...).
  version: 1.0.0
servers:
  - url: https://api.saspay.me/api/v1
security:
  - bearerAuth: []
paths:
  /merchant-kyc/{kyc_id}/documents/:
    get:
      tags:
        - KYC
      summary: Lister les documents d'un dossier
      description: >-
        Sur un dossier n'appartenant pas à votre marchand, renvoie 200 avec une
        liste vide plutôt qu'un 404 (contrairement au POST sur ce même chemin).
      parameters:
        - name: kyc_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Identifiant du dossier KYC
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            default: 20
            maximum: 100
          description: Taille de page, 100 maximum
      responses:
        '200':
          description: Liste paginée des documents du dossier
          content:
            application/json:
              example:
                count: 2
                next: null
                previous: null
                results:
                  - id: 1a2b3c4d-5e6f-4708-9a0b-1c2d3e4f5a6b
                    merchant_kyc: 5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f
                    document_type: ID_CARD
                    label: Recto CNI
                    file_url: >-
                      https://cdn.saspay.me/kyc/8f2c1e9a-6b4d-4a3f-9c1e-2b3d4e5f6a7b.jpg
                    created_at: '2026-08-10T09:05:00Z'
                  - id: 2b3c4d5e-6f70-4819-8a0b-2c3d4e5f6a7b
                    merchant_kyc: 5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f
                    document_type: BUSINESS_REGISTRATION
                    label: ''
                    file_url: >-
                      https://cdn.saspay.me/kyc/b7a6f5e4d3b2-e1c9-f3a4-d4b6-a9e1c2f8.pdf
                    created_at: '2026-08-10T09:07:00Z'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: sk_live_... / sk_test_...
      description: >-
        Clé API secrète du marchand — header Authorization: Bearer sk_live_xxx
        (ou sk_test_xxx en environnement de test).

````