Aller à la documentation
API

Récupérer un contact

Les adresses sont stockées en minuscules et la recherche procède de même : la casse dans le chemin n'a donc pas d'importance. La réponse pour un contact unique porte aussi `audiences`, c'est-à-dire toutes les listes dont le contact fait partie.

GETapi.openemail.uk/contacts/{email}

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

GET /contacts/{email}

Les adresses sont stockées en minuscules et la recherche procède de même : la casse dans le chemin n'a donc pas d'importance. La réponse pour un contact unique porte aussi audiences, c'est-à-dire toutes les listes dont le contact fait partie.

Exemple

Nécessite contacts:read. Encodez le @ dans l'URL.

curl
curl "$OE/contacts/ada%40example.com" -H "$AUTH"
Réponse
{  "object": "contact",  "email": "[email protected]",  "name": "Ada Lovelace",  "source": "auto",  "notes": null,  "lastSeenAt": "2026-08-29T08:19:08.000Z",  "createdAt": "2026-08-01T10:00:00.000Z",  "updatedAt": "2026-08-29T08:19:08.000Z",  "audiences": [    { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }  ]}

Une adresse inconnue donne un 404, pas un contact vide.

L'écriture est traitée sur les pages voisines : Créer un contact, Mettre à jour un contact et Supprimer un contact.