Obtener un correo

GET/v1/mails/{mail_id}

Para desarrolladores

Descripción

Devuelve el detalle de un correo a partir de su mail_id. Sirve para correos de cualquier fecha, sin indicar un rango: no aplica la ventana de 3 meses de GET /v1/mails. Si el correo es anterior a la retención en línea, responde 404 con el código mail_outside_retention.

Guía relacionada

• Enviar su primer correo — Haga el primer envío desde su sistema, por la API o por SMTP, con un ejemplo para copiar.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope mail:read. Formato: Bearer <API_KEY>.

X-Instance-Slugstringheaderobligatorio

Identificador de su instancia. Ver Autenticación.

Request

Path params:

mail_idstringobligatorio

Identificador del correo. Se obtiene con `GET /v1/mails`.

Response

200 OKDevuelve un objeto con los campos que siguen.

mail_idstringsiempre presente

Identificador del correo.

msg_idstring | null

Identificador del mensaje. Lo comparten todos los destinatarios de una misma llamada a `POST /v1/mails/send`.

tostringsiempre presente

Email del destinatario, uno por fila (ver Descripción).

subjectstringsiempre presente

Asunto.

senderstring | null

Email del remitente. null cuando el correo no tiene un remitente registrado.

statusinteger | null

Estado de entrega: 1=received, 2=queued, 3=sent, 4=dropped, 5=deferred, 6=bounced, 7=onhold.

opensintegersiempre presente

Cantidad de aperturas registradas.

clicksintegersiempre presente

Cantidad de clicks registrados.

received_atstring (date-time) | null

Fecha y hora de recepción.

queued_atstring (date-time) | null

Fecha y hora de encolado en el MTA.

sent_atstring (date-time) | null

Fecha y hora de entrega al MX del destinatario.

schedule_atstring (date-time) | null

Siempre es null: el envío programado no está disponible.

delaynumber | null

Demora de entrega en segundos, desde la recepción hasta sent_at.

custom_msg_idstring | null

Identificador personalizado del mensaje.

custom_group_codestring | null

Código de grupo personalizado.

Errores

Código	Cuándo
404	No existe un correo con ese mail_id en la instancia (mail_not_found).
404	El correo existió, pero es anterior a la retención en línea y ya no está disponible (mail_outside_retention).

Detalle en Errores genéricos (not-found) y Errores genéricos (mail-outside-retention).

Request

curl -X GET "https://$API_HOST/v1/mails/0190abc..." \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

{
"mail_id": "0190...",
"msg_id": "0190...",
"to": "[email protected]",
"subject": "Hello from Fidelizador",
"sender": "[email protected]",
"status": 3,
"opens": 1,
"clicks": 0,
"received_at": "2026-05-08T14:22:31Z",
"queued_at": "2026-05-08T14:22:32Z",
"sent_at": "2026-05-08T14:22:33Z",
"schedule_at": null,
"delay": 2.4,
"custom_msg_id": null,
"custom_group_code": null
}