Exporter la liste complète des transferts en CSV

L'endpoint GET /v1/transfers/export vous permet de récupérer en une seule requête l'ensemble des transferts de votre espace de travail. Contrairement à l'endpoint de liste paginé (GET /v1/transfers), celui-ci renvoie un dump plat : jusqu'à 10 000 lignes en une passe, trié par date de création décroissante. Vous pouvez demander une réponse au format CSV (fichier téléchargeable, idéal pour Excel ou Google Sheets) ou JSON (pour un traitement programmatique). Un paramètre status permet de restreindre l'export à un sous-ensemble de transferts.

Authentification

Cet endpoint nécessite une clé API avec le scope transfers:read. Passez votre clé dans le header Authorization au format Bearer : Authorization: Bearer cof_live_…. En environnement de test utilisez le préfixe cof_test_… ; en sandbox cof_sandbox_…. L'endpoint est classé expensive : son quota par minute est distinct du quota standard de lecture.

Paramètres de requête

L'export accepte un format (CSV ou JSON) et des filtres (statut, plage de dates). Le tableau ci-dessous détaille les paramètres acceptés.

Exemples de code

L'exemple ci-dessous exporte les transferts au format CSV, puis au format JSON. Choisissez votre langage.

# Export CSV complet (jusqu'à 5 000 lignes)
curl -G https://api.coffrify.com/v1/transfers/export \
  -H "Authorization: Bearer cof_live_VOTRE_CLE" \
  --data-urlencode "format=csv" \
  --data-urlencode "limit=5000" \
  -o coffrify-transfers.csv
 
# Filtrer uniquement les transferts actifs
curl -G https://api.coffrify.com/v1/transfers/export \
  -H "Authorization: Bearer cof_live_VOTRE_CLE" \
  --data-urlencode "format=csv" \
  --data-urlencode "status=active" \
  -o transferts-actifs.csv

Réponse

Format CSV : la réponse est un fichier texte avec les headers HTTP Content-Type: text/csv; charset=utf-8 et Content-Disposition: attachment; filename="coffrify-transfers-YYYY-MM-DD.csv". Le nom du fichier inclut la date du jour au format ISO. Les valeurs contenant des guillemets ou des virgules sont correctement échappées. Format JSON (par défaut) : la réponse est un objet avec les clés object, format, data, count, limit_reached et note. Si limit_reached vaut true, passez un limit plus élevé (max 10 000) ou filtrez par status.

{
  "object": "list",
  "format": "json",
  "data": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "short_code": "xK9mZ",
      "transfer_title": "Rapport Q1 2026",
      "status": "active",
      "expires_at": "2026-07-01T00:00:00Z",
      "max_downloads": 10,
      "total_downloads": 3,
      "scan_status": "clean",
      "encryption_mode": "standard",
      "is_password_protected": false,
      "watermark_enabled": false,
      "recipient_email": "client@example.com",
      "created_at": "2026-06-01T14:23:00Z"
    }
  ],
  "count": 1,
  "limit_reached": false,
  "note": null
}

Erreurs

Les erreurs portent sur un format invalide, un scope manquant ou un appel trop fréquent (expensive). Le tableau ci-dessous indique la résolution.

• Lister les transferts (paginé)
• Créer un transfert
• Comprendre les scopes d'API
• Gérer les clés API
• Limites de taux (rate limits)