Se connecterCommencer gratuitement
Référence APILister les fichiers stockés
GET/v1/storage

Lister les fichiers stockés

Récupère tous les fichiers de votre workspace avec leur région de stockage et un récapitulatif d'occupation.

2 min de lectureTélécharger en PDF

Réponse exemple

{
  "files": [
    {
      "id": "file_8f2a1c9b-44de-4f10-9b27-7c0e2a1d33aa",
      "file_name": "contrat-cession-2026.pdf",
      "file_size": 482113,
      "file_type": "application/pdf",
      "created_at": "2026-06-04T09:21:44.512Z",
      "transfer_id": "trf_3c1d99e0-2b41-4a77-8e10-0f9a2c5b7711",
      "storage_region": "eu-par-1"
    },
    {
      "id": "file_1d77ab02-9e3c-4c55-bf20-5a8e1f2c4400",
      "file_name": "annexe-financiere.xlsx",
      "file_size": 91240,
      "file_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
      "created_at": "2026-06-03T16:02:10.118Z",
      "transfer_id": "trf_3c1d99e0-2b41-4a77-8e10-0f9a2c5b7711",
      "storage_region": "eu-fra-1"
    }
  ],
  "by_region": {
    "eu-fra-1": {
      "bytes": 91240,
      "count": 1
    },
    "eu-par-1": {
      "bytes": 482113,
      "count": 1
    }
  },
  "total_bytes": 573353
}
GET/v1/storageListe les fichiers stockés du workspace authentifié, avec total et répartition par région.

Cet endpoint retourne l'ensemble des fichiers rattachés aux transferts de votre workspace, accompagnés de la région de stockage de chaque fichier et de deux agrégats utiles : le volume total occupé et une répartition par région. Il fonctionne en deux temps côté serveur : il collecte d'abord les identifiants de transfert du workspace (plafonnés à 5000), puis charge les fichiers correspondants (plafonnés à 2000), triés du plus récent au plus ancien. Si le workspace ne possède aucun transfert, la réponse renvoie immédiatement des collections vides plutôt qu'une erreur.

Authentification

L'appel exige une clé API valide portant le scope transfers:read. Le périmètre des données est automatiquement restreint au workspace de la clé : seuls les fichiers des transferts dont vous êtes propriétaire sont retournés.

Paramètres de requête

Cet endpoint n'accepte aucun paramètre de requête. La liste est toujours bornée par le serveur (jusqu'à 2000 fichiers, transferts scannés jusqu'à 5000) et triée par created_at décroissant.

Réponse

La réponse contient trois clés. files est la liste des fichiers, chacun exposant id, file_name, file_size (octets, potentiellement nul), file_type, storage_region, transfer_id et created_at. total_bytes est la somme des tailles de tous les fichiers listés. by_region est un dictionnaire indexé par région, où chaque entrée fournit count (nombre de fichiers) et bytes (volume cumulé). Lorsqu'un fichier ne porte pas de région, il est rattaché par défaut à eu-par-1.

ChampTypeDescription
filesarrayListe des fichiers du workspace (max 2000, triés du plus récent au plus ancien).
files[].idstringIdentifiant unique du fichier.
files[].file_namestringNom du fichier d'origine.
files[].file_sizenumber | nullTaille en octets, ou null si inconnue.
files[].file_typestringType MIME du fichier.
files[].storage_regionstringRégion de stockage (par défaut eu-par-1 si absente).
files[].transfer_idstringTransfert parent auquel le fichier appartient.
files[].created_atstring (ISO 8601)Date de création du fichier.
total_bytesnumberSomme des tailles de tous les fichiers listés.
by_regionobjectRépartition par région : { count, bytes } par clé de région.

Erreurs

CodeQuandRésolution
missing_api_key (401)Aucune clé API fournie dans l'en-tête Authorization.Ajoutez un en-tête Authorization: Bearer <clé>.
invalid_api_key (401)Clé API inconnue ou malformée.Vérifiez la clé et régénérez-la si besoin depuis la console.
scope_missing (403)La clé ne porte pas le scope transfers:read.Accordez le scope transfers:read à la clé.
rate_limited (429)Quota par minute du workspace dépassé sur les endpoints de lecture.Patientez selon l'en-tête Retry-After, puis réessayez.
internal_error (500)Échec de lecture côté base de données.Réessayez ; si l'erreur persiste, contactez le support avec le X-Request-Id.

Voir aussi