Listar y recuperar
Encuentra mensajes y comprueba qué fue de uno.
Ejecuta cualquiera de las 3 llamadas de esta página contra tu espacio de trabajo, con tu propia clave.
Listar
GET /emails, del más nuevo al más antiguo. Filtra con status (separado por comas) y from. La paginación es por keyset, no por offset: pasa el nextCursor que se te dio. La paginación por offset se salta filas en silencio cuando llegan mensajes nuevos mientras paginas.
{ "object": "list", "data": [ … ], "hasMore": true, "nextCursor": "msg_01j8…" }Una fila con seguimiento lleva además un objeto tracking compacto: opens, clicks, opened, clicked, openCount, clickCount, firstOpenAt. Una fila sin seguimiento no lleva ninguna clave tracking: openCount: 0 en un mensaje que nunca llevó un píxel se lee como «nadie lo abrió», que es una afirmación que no estamos en posición de hacer.
Recuperar uno
GET /emails/{id} devuelve el mensaje con el estado de entrega por destinatario, y el informe de seguimiento COMPLETO en lugar del resumen de la lista, ya que una recuperación sí puede permitirse el desglose por destinatario y los enlaces. Un id que no existe es un 404, nunca un éxito inventado.
| Estado del destinatario | Significa |
|---|---|
| pending | Todavía no transmitido. |
| delivered | Entregado al transporte para esta dirección. |
| failed | El transporte lo rechazó. |
| uncertain | Un transporte falló a medias y no puede decir a qué destinatarios llegó. Se muestra tal cual en lugar de adivinarlo en un sentido u otro. |
Eventos
GET /emails/{id}/events devuelve el rastro, del más antiguo al más nuevo: email.accepted, email.queued, email.scheduled, email.sent, email.failed, email.cancelled, email.rescheduled y, en un mensaje con seguimiento, email.opened, email.clicked y email.downloaded según ocurren. Para que te avisen en lugar de consultarlos en bucle, registra un webhook.