Lister les messages
Ce qui est arrivé, du plus récent au plus ancien, métadonnées seulement. C'est l'appel à interroger en boucle.
Exécute le véritable appel sur votre espace de travail, avec votre propre clé.
GET /temp-mail/inboxes/{id}/messages
Ce qui est arrivé, du plus récent au plus ancien, métadonnées seulement. C'est l'appel à interroger en boucle.
Le jeton de boîte
export OE=https://api.openemail.ukexport INBOX="Authorization: Bearer oe_inbox_kQ8v…"Chaque appel ci-dessous transporte le jeton renvoyé par POST /temp-mail/inboxes, dans le même en-tête Authorization: Bearer qu'utilise une clé API. L'adresse elle-même n'autorise rien, et cette séparation est l'intérêt même de la fonctionnalité plutôt qu'une formalité : une adresse jetable est remise, dès qu'elle est émise, à la partie que vous tenez à distance.
L'id dans le chemin doit désigner la même boîte que le jeton. Le jeton seul en identifie une, c'est donc ceinture et bretelles, mais cela signifie qu'un appelant qui confond deux boîtes reçoit un 404 au lieu de lire discrètement le mauvais courrier.
Exemple
Tout ce qu'une liste affiche est une colonne d'une seule table indexée, et aucun corps stocké n'est lu. limit va de 1 à 50 et est facultatif ; le bail revient dans la même réponse, si bien qu'un scrutateur n'a pas besoin d'un second appel pour savoir quand s'arrêter.
curl "$OE/temp-mail/inboxes/tinb_9c2f41ab7d3e4c118a0f5d72/messages?limit=25" -H "$INBOX"{ "object": "list", "data": [ { "object": "temp_message", "id": "tmail_4b81c07d2fa9418e93c6a13f", "from": { "name": "Acme", "email": "[email protected]" }, "to": "[email protected]", "subject": "Confirm your email", "snippet": "Your code is 481923…", "spam": false, "seen": false, "attachmentCount": 0, "sizeBytes": 8241, "receivedAt": "2026-09-01T10:31:04.000Z" } ], "expiresAt": "2026-09-01T12:00:00.000Z"}snippet est constitué des 400 premiers caractères du corps en texte, ce qui est généralement toute la raison d'être de la boîte. Un code de confirmation est en général visible sans rien ouvrir.
spam est l'avis de l'heuristique partagée. Ce n'est qu'un indicateur : rien n'a été classé, déplacé ni supprimé, et le message figure dans cette liste dans tous les cas.
seen bascule à la récupération du message, pas à son listage. Interroger cet endpoint en boucle ne marque jamais rien comme lu.