Historique 360 d'un destinataire

Réponse exemple

{
  "email": "marie.durand@exemple.fr",
  "requests": [
    {
      "id": "rsb_a1d4f9c2e7b3",
      "created_at": "2026-04-18T11:10:05.000Z",
      "submitted_at": "2026-04-18T11:47:33.000Z"
    }
  ],
  "transfers": [
    {
      "id": "trf_8f2a1c9d4e6b",
      "opened_at": "2026-05-28T15:03:42.000Z",
      "created_at": "2026-05-28T14:22:17.000Z",
      "downloaded_at": "2026-05-28T15:05:10.000Z"
    },
    {
      "id": "trf_3b7e0a5f1d2c",
      "opened_at": null,
      "created_at": "2026-03-12T09:41:00.000Z",
      "downloaded_at": null
    }
  ],
  "last_interaction": "2026-05-28T14:22:17.000Z",
  "first_interaction": "2026-03-12T09:41:00.000Z"
}

Cette route renvoie une vue consolidee de l'activite d'une adresse e-mail destinataire au sein de votre espace de travail. Elle agrege en un seul appel les transferts envoyes a cette adresse (avec leurs horodatages d'ouverture et de telechargement) et les soumissions de demandes effectuees depuis cette adresse. Elle calcule egalement la premiere et la derniere interaction observees, ce qui en fait un point d'entree pratique pour les pages de diagnostic, le support client et l'analyse d'engagement. La correspondance sur l'e-mail est insensible a la casse : l'adresse fournie dans l'URL est normalisee en minuscules et comparee via ilike. Chaque liste est plafonnee aux 200 entrees les plus recentes, triees par date de creation decroissante.

Authentification

Requiert une cle API valide presentee via l'en-tete Authorization: Bearer cof_live_... et le scope transfers:read. Une cle sans ce scope est rejetee avec une erreur scope_missing (HTTP 403).

Parametres de requete

L'adresse e-mail est passee comme segment de chemin ({email}), pas comme parametre de requete. Elle doit etre encodee pour l'URL (par exemple marie.durand%40exemple.fr). Cette route n'accepte aucun parametre de requete (query string) ni corps.

Reponse

La reponse renvoie l'adresse normalisee (email), les horodatages first_interaction et last_interaction (chaine ISO 8601, ou chaine vide si aucune interaction), puis deux listes. Chaque entree de transfers expose id, created_at, opened_at et downloaded_at (ces deux derniers valant null si le destinataire n'a pas encore ouvert ou telecharge). Chaque entree de requests expose id, created_at et submitted_at (submitted_at est null tant que la demande n'a pas ete soumise).

Erreurs

Voir aussi

• GET /v1/transfers — lister les transferts de l'espace de travail avec pagination.
• GET /v1/requests — lister les demandes et leurs soumissions.
• GET /v1/transfers/{id} — recuperer le detail d'un transfert specifique.