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

# API d'export des fichiers de session : un seul ZIP

> Exportez en un seul ZIP tous les fichiers Didit d'une session KYC ou KYB, en qualité originale, via POST /v3/session/{id}/files-export/.

Préparez un seul fichier ZIP contenant tous les fichiers d'une session de Vérification des utilisateurs (KYC) ou de Vérification d'entreprise (KYB) : recto et verso des documents, selfies, vidéos de détection du vivant et documents téléversés, en qualité d'origine.

Le ZIP est préparé en arrière-plan. L'appel renvoie `202` avec l'export ; consultez-le avec [Obtenir l'export des fichiers](https://docs.didit.me/fr/sessions-api/get-files-export.md) jusqu'à ce que `status` soit `READY`, puis téléchargez `download_url`.

* Tant qu'un export de la même session est encore en cours de préparation, l'appel renvoie cet export au lieu d'en lancer un nouveau.
* Le ZIP est supprimé 24 heures après sa disponibilité, et immédiatement lorsque la session est supprimée.
* Une session supprimée ne peut pas être exportée : l'appel renvoie `404`.
* Chaque export est inscrit dans le journal d'audit de la session.
* Une clé API à portée limitée doit disposer des autorisations `media: read` et `decisions: read`.


## OpenAPI

````yaml fr/openapi-25.json POST /v3/session/{sessionId}/files-export/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/files-export/:
    post:
      tags:
        - Sessions
      summary: Exporter tous les fichiers d'une session
      description: >-
        Démarrer la préparation d'un fichier ZIP contenant chaque image, vidéo
        et document d'une session de Vérification des utilisateurs (KYC) ou de
        Vérification d'entreprise (KYB), en qualité originale : les fichiers
        sont stockés dans le ZIP tels qu'ils ont été capturés, sans jamais être
        recompressés. Répond `202` avec l'export ; lisez-le avec `GET
        /v3/session/{sessionId}/files-export/{exportId}/` jusqu'à ce que
        `status` soit `READY`, puis téléchargez `download_url`. Tant qu'un
        export de la même session est toujours en cours de préparation, cet
        export est renvoyé au lieu d'en créer un nouveau.


        Le ZIP est supprimé 24 heures après qu'il est prêt, et immédiatement
        lorsque la session est supprimée. Une session supprimée ne peut pas être
        exportée. Chaque export et chaque lien de téléchargement délivré est
        consigné dans le journal d'audit de la session. Une clé API restreinte
        nécessite `media: read` et `decisions: read` ; un utilisateur de la
        console a besoin de l'autorisation de lire les sessions.
      operationId: post_v3_session_files_export
      parameters:
        - name: sessionId
          in: path
          required: true
          description: >-
            UUID de la session de vérification (le `session_id` renvoyé par
            `POST /v3/session/`). Accepte les identifiants de session de
            Vérification des utilisateurs (KYC) et de Vérification d'entreprise
            (KYB). Une session supprimée renvoie `404`.
          schema:
            type: string
            format: uuid
            example: 11111111-2222-3333-4444-555555555555
      responses:
        '202':
          description: L'export, en cours de préparation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionFilesExport'
              example:
                export_id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
                session_id: 11111111-2222-3333-4444-555555555555
                status: PENDING
                file_count: null
                size_bytes: null
                download_url: null
                expires_at: null
                error: null
                created_at: '2026-10-29T12:00:03Z'
                completed_at: null
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X POST
            'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/files-export/'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.sessions.export_files(
                "11111111-2222-3333-4444-555555555555",
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: >-
            import Didit from "@didit-protocol/sdk-node";


            // Reads DIDIT_API_KEY.

            const didit = new Didit();


            const result = await
            didit.sessions.exportFiles("11111111-2222-3333-4444-555555555555");

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.ExportFiles(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import me.didit.Didit;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.sessions().exportFiles("11111111-2222-3333-4444-555555555555");

            System.out.println(result);
        - lang: php
          label: PHP
          source: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->sessions->exportFiles('11111111-2222-3333-4444-555555555555');

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY.

            didit = Didit::Client.new


            result =
            didit.sessions.export_files("11111111-2222-3333-4444-555555555555")

            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await
            client.Sessions.ExportFilesAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    SessionFilesExport:
      type: object
      description: >-
        Un fichier ZIP contenant chaque fichier d'une session, dans sa qualité
        d'origine.
      required:
        - export_id
        - session_id
        - status
        - file_count
        - size_bytes
        - download_url
        - expires_at
        - error
        - created_at
        - completed_at
      properties:
        export_id:
          type: string
          format: uuid
          description: >-
            Identifiant de l'export. Transmettez-le à `GET
            /v3/session/{sessionId}/files-export/{exportId}/`.
        session_id:
          type: string
          format: uuid
          description: La session dont proviennent les fichiers.
        status:
          type: string
          enum:
            - PENDING
            - PROCESSING
            - READY
            - FAILED
            - EXPIRED
          description: >-
            `PENDING` et `PROCESSING` pendant la préparation du ZIP, `READY` dès
            qu'il peut être téléchargé, `FAILED` lorsqu'il n'a pas pu être
            préparé (demandez un nouvel export), `EXPIRED` une fois le ZIP
            supprimé.
        file_count:
          type: integer
          nullable: true
          description: >-
            Fichiers dans le ZIP. Défini uniquement tant que `status` est
            `READY`.
        size_bytes:
          type: integer
          format: int64
          nullable: true
          description: >-
            Taille du ZIP en octets. Renseignée uniquement lorsque `status` est
            `READY`.
        download_url:
          type: string
          format: uri
          nullable: true
          description: >-
            URL signée du ZIP, valide pendant une courte durée. Renseignée
            uniquement lorsque `status` est `READY` ; relisez l'export pour en
            obtenir une nouvelle.
        expires_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Date et heure de suppression du fichier ZIP, 24 heures après qu'il a
            été prêt. Défini uniquement lorsque `status` est `READY`.
        error:
          type: string
          nullable: true
          description: >-
            Raison pour laquelle l'export a échoué, lorsque `status` est
            `FAILED`.
        created_at:
          type: string
          format: date-time
          description: Date et heure de demande de l'export.
        completed_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Date et heure auxquelles le fichier ZIP était prêt ou auxquelles
            l'export a échoué.
  responses:
    Unauthorized:
      description: Non autorisé
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Clé API non valide
              value:
                detail: Invalid API Key.
    Forbidden:
      description: Interdit
      content:
        application/json:
          examples:
            No Permission:
              summary: Aucune autorisation
              value:
                detail: You do not have permission to perform this action.
            Not Enough Credits:
              summary: Crédits insuffisants
              value:
                error: >-
                  You don't have enough credits to perform this request. Please
                  top up at https://business.didit.me
    NotFound:
      description: Introuvable
      content:
        application/json:
          examples:
            Not Found:
              summary: Introuvable
              value:
                detail: Resource not found.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clé API de votre application, issue de Développeurs -> Clés API dans
        la Business Console. La clé principale dispose d'un accès complet. Une
        clé nommée peut être restreinte : aucun, lecture ou écriture par
        ressource, limitée à certains workflows ou aux sessions approuvées, à
        une liste d'adresses IP et à une date d'expiration. 401 signifie que la
        clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a
        été envoyée, que la clé n'a pas accès à cette ressource ou action, ou
        que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur
        une route de session signifie que la session est hors des workflows ou
        des statuts de la clé. Une clé sans accès aux médias reçoit les URL
        d'images, de vidéos et de PDF à null, et une clé sans accès en écriture
        aux sessions reçoit les liens et tokens de session à null. Voir
        https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.