Se connecterCommencer gratuitement
Référence APILister les soumissions d'une demande
GET/v1/requests/{id}/submissions

Lister les soumissions d'une demande

Récupère la liste des soumissions reçues pour une demande de fichiers donnée, avec filtrage optionnel par statut.

1 min de lectureTélécharger en PDF

Réponse exemple

{
  "data": [
    {
      "id": "sub_4d7e9a1b3c",
      "note": "Voici les pièces demandées pour le dossier 2026.",
      "status": "pending",
      "request_id": "req_8f3a1c9e2b",
      "reviewed_at": null,
      "reviewed_by": null,
      "total_files": 3,
      "transfer_id": "tr_9c2e7f1a5d",
      "submitted_at": "2026-06-04T14:22:08.000Z",
      "submitter_ip": "82.64.12.34",
      "workspace_id": "ws_2a6b8c0d4e",
      "submitter_name": "Marie Durand",
      "submitter_email": "marie.durand@example.com",
      "total_size_bytes": 18452310,
      "submitter_country": "FR"
    }
  ],
  "object": "list",
  "request_id": "req_8f3a1c9e2b"
}
GET/v1/requests/{id}/submissionsListe les soumissions rattachées à une demande de fichiers.

Renvoie l'ensemble des soumissions déposées par les répondants pour une demande de fichiers (request) identifiée par {id}. Chaque soumission représente l'envoi d'un répondant : son identité déclarée, le transfert associé, le volume de fichiers et le statut de revue. L'endpoint vérifie d'abord que la demande appartient bien au workspace de la clé API ; si ce n'est pas le cas, il répond 404 sans divulguer l'existence de la ressource. Les résultats sont triés par date de soumission décroissante (submitted_at).

Authentification

Requiert une clé API valide portant le scope transfers:write. Le scope plus large transfers:* ou le wildcard * satisfont également cette exigence. La demande ciblée est automatiquement restreinte au workspace de la clé : aucune soumission d'un autre workspace n'est accessible.

Paramètres de requête

ParamètreTypeRequisDescription
statusstringNonFiltre les soumissions sur un statut précis. Valeurs acceptées : pending, reviewed, approved, rejected, spam. Une valeur invalide renvoie une erreur 400.
limitintegerNonNombre maximum de soumissions retournées. Borné entre 1 et 500 ; valeur par défaut 200. Toute valeur hors limites est ramenée dans cet intervalle.

Réponse

Renvoie un objet de liste : object vaut "list", request_id reprend l'identifiant de la demande, et data contient le tableau des soumissions. Chaque soumission expose id, request_id, workspace_id, l'identité déclarée (submitter_name, submitter_email, submitter_ip, submitter_country), le message libre (note), le status, le transfer_id lié, les compteurs total_files et total_size_bytes, ainsi que la chronologie de revue (submitted_at, reviewed_at, reviewed_by). Si aucune soumission ne correspond, data est un tableau vide.

Erreurs

CodeQuandRésolution
400 validation_errorLe paramètre status ne fait pas partie des valeurs autorisées.Utiliser l'une des valeurs : pending, reviewed, approved, rejected, spam.
401 invalid_api_keyClé API absente, mal préfixée, introuvable ou révoquée.Fournir une clé valide via l'en-tête Authorization: Bearer cof_live_....
403 scope_missingLa clé ne porte pas le scope transfers:write.Générer une nouvelle clé avec le scope requis sur https://app.coffrify.com/developer.
404 not_foundLa demande {id} n'existe pas ou n'appartient pas au workspace.Vérifier l'identifiant de la demande et le workspace de la clé.
429 rate_limitedQuota de requêtes par minute du workspace dépassé.Respecter l'en-tête Retry-After et lisser la cadence des appels.
500 internal_errorErreur interne lors de la lecture en base.Réessayer ; si le problème persiste, contacter le support avec le request_id.

Voir aussi