# Exporter les données d'un coffre

> Produisez l'export structuré d'un coffre pour répondre à une demande de portabilité d'un patient (RGPD, article 20).

L'export d'un coffre rassemble, en un seul JSON, la description du coffre, la liste de ses documents, ses consentements et ses partages actifs. Il sert de base à la réponse à une demande d'accès ou de portabilité.

## Avant de commencer

- L'utilisateur porte `HDS_PATIENT` ou `HDS_ADMIN`.
- Il est propriétaire du coffre ou destinataire d'un partage actif. Pour qu'un patient exporte son dossier, partagez-lui d'abord le coffre. Voir [Partager un coffre](/v1.0/hds/partager-un-coffre).

## Exporter le coffre

::::tabs{sync="lang"}
:::tab{label="cURL"}
```bash
curl "https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/export" \
  -H "Authorization: Bearer $USER_TOKEN" \
  -o export-vlt_a1B2c3D4.json
```
:::
:::tab{label="TypeScript"}
```typescript
import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.wakastart.app/api/hds/vaults/vlt_a1B2c3D4/export", {
  headers: { Authorization: `Bearer ${process.env.USER_TOKEN}` },
});
if (!response.ok) throw new Error(`${response.status}`);
await writeFile("export-vlt_a1B2c3D4.json", JSON.stringify(await response.json(), null, 2));
```
:::
::::

Réponse attendue (extrait) :

```json
{
  "exportVersion": "1.0",
  "exportedAt": "2026-10-23T12:00:00.000Z",
  "vault": {
    "vaultId": "vlt_a1B2c3D4",
    "type": "PATIENT",
    "status": "ACTIVE",
    "label": "Dossier de Marie Exemple",
    "retentionPolicy": "STANDARD",
    "storageUsedBytes": 280832,
    "documentCount": 2,
    "createdAt": "2026-10-23T10:02:17.441Z",
    "updatedAt": "2026-10-23T10:31:44.130Z"
  },
  "documents": [
    {
      "docId": "doc_Pz3Vb6Nc",
      "folderId": "fld_Lm4Rt8Ws",
      "originalFilename": "ordonnance-2026-10-23.pdf",
      "mimeType": "application/pdf",
      "sizeBytes": 96512,
      "status": "QUARANTINED",
      "currentVersion": 1,
      "tags": [],
      "uploadedBy": "8f14e45f-ceea-467f-a0e6-2d2d3a7c1b11",
      "legalHold": false,
      "createdAt": "2026-10-23T10:31:44.120Z",
      "updatedAt": "2026-10-23T10:31:44.120Z"
    }
  ],
  "consents": [],
  "shares": []
}
```

L'export contient les **métadonnées** des documents, pas leur contenu. Les documents supprimés n'y figurent pas.

## Vérifier le résultat

- `documents` liste les documents non supprimés du coffre.
- Le journal d'audit contient `VAULT_EXPORTED`, avec le nombre de documents, de consentements et de partages exportés.

## Voir aussi

- [Responsabilités du client](/v1.0/hds/responsabilites-du-client)
- [Référence : export d'un coffre](/v1.0/hds/reference#exporter-un-coffre)
