> ## 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.

# Ekspor File Sesi API: Unduh Semua File dalam Satu ZIP

> Panggil POST /v3/session/{id}/files-export/ di Didit untuk menyiapkan satu ZIP berisi semua gambar, video, dan dokumen sesi KYC atau KYB, dalam kualitas asli.

Siapkan satu ZIP berisi setiap file dari sesi Verifikasi Pengguna (KYC) atau Verifikasi Bisnis (KYB): sisi dokumen, swafoto, video liveness, dan dokumen yang diunggah, dalam kualitas asli.

ZIP disiapkan di latar belakang. Panggilan ini merespons dengan `202` beserta ekspor. Baca ekspor tersebut dengan [Get files export](https://docs.didit.me/id/sessions-api/get-files-export.md) sampai `status` bernilai `READY`, lalu unduh `download_url`.

* Selama ekspor untuk sesi yang sama masih disiapkan, panggilan mengembalikan ekspor tersebut alih-alih memulai ekspor baru.
* ZIP dihapus 24 jam setelah siap, dan segera saat sesi dihapus.
* Sesi yang sudah dihapus tidak dapat diekspor: panggilan mengembalikan `404`.
* Setiap ekspor dicatat di log audit sesi.
* Kunci API dengan cakupan memerlukan `media: read` dan `decisions: read`.


## OpenAPI

````yaml id/openapi-25.json POST /v3/session/{sessionId}/files-export/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: API Verifikasi Identitas. Lakukan autentikasi dengan header x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/files-export/:
    post:
      tags:
        - Sessions
      summary: Ekspor setiap file dari suatu sesi
      description: >-
        Mulai menyiapkan satu ZIP berisi setiap gambar, video, dan dokumen dari
        sesi Verifikasi Pengguna (KYC) atau Verifikasi Bisnis (KYB), dalam
        kualitas asli: file disimpan di dalam ZIP sesuai hasil pengambilan awal,
        tidak pernah dikompresi ulang. Menjawab `202` dengan ekspor tersebut;
        baca dengan `GET /v3/session/{sessionId}/files-export/{exportId}/`
        hingga `status` menjadi `READY`, lalu unduh `download_url`. Saat ekspor
        untuk sesi yang sama masih disiapkan, ekspor tersebut dikembalikan
        alih-alih membuat yang baru.


        File ZIP akan dihapus 24 jam setelah siap, dan seketika saat sesi
        dihapus. Sesi yang telah dihapus tidak dapat diekspor. Setiap ekspor dan
        setiap tautan unduhan yang diberikan dicatat ke dalam log audit sesi.
        Kunci API dengan cakupan membutuhkan `media: read` dan `decisions:
        read`; pengguna konsol membutuhkan hak istimewa untuk membaca sesi.
      operationId: post_v3_session_files_export
      parameters:
        - name: sessionId
          in: path
          required: true
          description: >-
            UUID sesi verifikasi (`session_id` yang dikembalikan oleh `POST
            /v3/session/`). Menerima ID sesi Verifikasi Pengguna (KYC) dan
            Verifikasi Bisnis (KYB). Sesi yang dihapus mengembalikan `404`.
          schema:
            type: string
            format: uuid
            example: 11111111-2222-3333-4444-555555555555
      responses:
        '202':
          description: Ekspor, sedang disiapkan.
          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: Satu file ZIP berisi setiap file dari sebuah sesi, dalam kualitas asli.
      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: >-
            ID ekspor. Teruskan ke `GET
            /v3/session/{sessionId}/files-export/{exportId}/`.
        session_id:
          type: string
          format: uuid
          description: Sesi asal file-file tersebut.
        status:
          type: string
          enum:
            - PENDING
            - PROCESSING
            - READY
            - FAILED
            - EXPIRED
          description: >-
            `PENDING` dan `PROCESSING` saat ZIP sedang disiapkan, `READY`
            setelah dapat diunduh, `FAILED` ketika tidak dapat disiapkan (minta
            ekspor baru), `EXPIRED` setelah ZIP dihapus.
        file_count:
          type: integer
          nullable: true
          description: File di dalam ZIP. Diatur hanya ketika `status` bernilai `READY`.
        size_bytes:
          type: integer
          format: int64
          nullable: true
          description: Ukuran ZIP dalam bita. Diatur hanya saat `status` adalah `READY`.
        download_url:
          type: string
          format: uri
          nullable: true
          description: >-
            URL ZIP yang ditandatangani, valid untuk waktu singkat. Diatur hanya
            saat `status` adalah `READY`; baca ekspor lagi untuk mendapatkan
            yang baru.
        expires_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Waktu ketika ZIP dihapus, 24 jam setelah siap. Hanya diatur selama
            `status` bernilai `READY`.
        error:
          type: string
          nullable: true
          description: Alasan mengapa ekspor gagal, saat `status` adalah `FAILED`.
        created_at:
          type: string
          format: date-time
          description: Waktu ketika ekspor diminta.
        completed_at:
          type: string
          format: date-time
          nullable: true
          description: Waktu ketika ZIP siap atau ekspor gagal.
  responses:
    Unauthorized:
      description: Tidak diotorisasi
      content:
        application/json:
          examples:
            Invalid API Key:
              summary: Kunci API tidak valid
              value:
                detail: Invalid API Key.
    Forbidden:
      description: Dilarang
      content:
        application/json:
          examples:
            No Permission:
              summary: Tidak Ada Izin
              value:
                detail: You do not have permission to perform this action.
            Not Enough Credits:
              summary: Kredit Tidak Cukup
              value:
                error: >-
                  You don't have enough credits to perform this request. Please
                  top up at https://business.didit.me
    NotFound:
      description: Tidak Ditemukan
      content:
        application/json:
          examples:
            Not Found:
              summary: Tidak Ditemukan
              value:
                detail: Resource not found.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Kunci API aplikasi Anda, dari Developers -> API keys di Business
        Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi
        cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa
        alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan
        pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau
        kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak
        memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang
        dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi
        berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses
        media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa
        izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat
        https://docs.didit.me/console/api-keys.

````

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