Passer au contenu principal
GET
curl
Lisez un export lancé avec Exporter les fichiers.
  • PENDING et PROCESSING : le ZIP est en cours de préparation. Relisez l’export dans quelques secondes.
  • READY : download_url est un lien signé vers le ZIP, valable pendant une courte durée. Relisez l’export pour obtenir un nouveau lien jusqu’à expires_at.
  • FAILED : le ZIP n’a pas pu être préparé. Lancez un nouvel export.
  • EXPIRED : le ZIP a été supprimé. Lancez un nouvel export.
Chaque lecture qui fournit un lien de téléchargement est consignée dans le journal d’audit de la session. Un export d’une session supprimée renvoie 404.

Autorisations

x-api-key
string
header
requis

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.

Paramètres de chemin

sessionId
string<uuid>
requis

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.

Exemple:

"11111111-2222-3333-4444-555555555555"

exportId
string<uuid>
requis

L'export_id renvoyé par POST /v3/session/{sessionId}/files-export/.

Exemple:

"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"

Réponse

L'export.

Un fichier ZIP contenant chaque fichier d'une session, dans sa qualité d'origine.

export_id
string<uuid>
requis

Identifiant de l'export. Transmettez-le à GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
requis

La session dont proviennent les fichiers.

status
enum<string>
requis

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

Options disponibles:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
requis

Fichiers dans le ZIP. Défini uniquement tant que status est READY.

size_bytes
integer<int64> | null
requis

Taille du ZIP en octets. Renseignée uniquement lorsque status est READY.

download_url
string<uri> | null
requis

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
string<date-time> | null
requis

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
string | null
requis

Raison pour laquelle l'export a échoué, lorsque status est FAILED.

created_at
string<date-time>
requis

Date et heure de demande de l'export.

completed_at
string<date-time> | null
requis

Date et heure auxquelles le fichier ZIP était prêt ou auxquelles l'export a échoué.

Dernière modification le 7 novembre 2026