Se connecterCommencer gratuitement
Référence APILister les data rooms du workspace
GET/v1/workspace/datarooms

Lister les data rooms du workspace

Retourne la liste paginée des data rooms M&A du workspace courant, enrichies des compteurs de viewers, documents et de la dernière activité.

2 min de lectureTélécharger en PDF

Réponse exemple

{
  "data": [
    {
      "id": "a1f2c3d4-5678-49ab-9cde-0123456789ab",
      "name": "Projet Hélios - Cession majoritaire",
      "status": "active",
      "closed_at": null,
      "reference": "DR-7K9M-2X4P",
      "created_at": "2026-06-05T10:15:00.000Z",
      "expires_at": "2026-09-03T10:15:00.000Z",
      "updated_at": "2026-06-05T10:15:00.000Z",
      "archived_at": null,
      "description": "Data room de due diligence pour la cession de 60% du capital.",
      "nda_required": true,
      "viewers_count": 8,
      "target_company": "Hélios Industries SAS",
      "documents_count": 42,
      "last_activity_at": "2026-06-05T14:22:10.000Z",
      "viewers_active_count": 5
    }
  ],
  "object": "list"
}
GET/v1/workspace/dataroomsListe paginée des data rooms M&A du workspace actif.

Retourne l'ensemble des data rooms (espaces de due diligence M&A) rattachées au workspace courant, triées de la plus récente à la plus ancienne (created_at décroissant). Chaque entrée est enrichie de compteurs calculés à la volée : nombre total de viewers, viewers actifs, nombre de documents et horodatage de la dernière consultation. Le workspace ciblé est résolu via le cookie cf-workspace-id lorsqu'il est présent, sinon le premier workspace actif de l'utilisateur est utilisé. La réponse n'inclut pas de curseur de pagination : seul un plafond limit est appliqué.

Authentification

Cet endpoint s'appuie sur une session Supabase valide (cookies d'authentification) et non sur une clé API à scope. Aucun scope spécifique n'est requis : clé API valide, aucun scope spécifique. L'appelant doit néanmoins être membre actif (status = active) du workspace résolu via la table coffrify_workspace_members. La lecture est autorisée pour tous les rôles, y compris viewer et auditor.

Paramètres de requête

ParamètreTypeRequisDescription
statusstringNonFiltre par statut. Valeurs acceptées : draft, active, archived, closed. Toute autre valeur est ignorée (aucun filtre appliqué).
qstringNonRecherche plein texte insensible à la casse sur name, reference et target_company (correspondance partielle ilike).
limitintegerNonNombre maximal de data rooms retournées. Borné entre 1 et 100, valeur par défaut 50.

Réponse

La réponse est un objet { object: "list", data: [...] }. Chaque élément expose les métadonnées de la data room (id, reference, name, target_company, description, status, nda_required, expires_at, closed_at, archived_at, created_at, updated_at) ainsi que quatre compteurs dérivés : viewers_count (total), viewers_active_count (viewers au statut active), documents_count et last_activity_at (date de la dernière vue enregistrée, ou null si aucune).

Erreurs

CodeQuandRésolution
401 UnauthorizedAucune session Supabase valide (auth.getUser() ne retourne aucun utilisateur).Authentifiez la requête avec une session valide.
404 No active workspaceL'utilisateur n'est membre actif d'aucun workspace, ou le cookie cf-workspace-id ne correspond à aucune appartenance active.Vérifiez l'appartenance au workspace et le cookie cf-workspace-id.
500 InternalErreur de la requête de lecture côté base (message d'erreur Supabase remonté).Réessayez ; si l'erreur persiste, contactez le support.

Voir aussi