Listar las respuestas a un correo

GET/v1/mails/{mail_id}/replies

Para desarrolladores

Descripción

Lista las respuestas que recibió un correo, de la más reciente a la más antigua. Incluye las respuestas automáticas (un aviso de ausencia, por ejemplo) y las que el antispam marcó, cada una con su marca, así que puede quedarse solo con las que escribió una persona. Entrega los datos de cada respuesta, no su contenido: el asunto, el texto y los adjuntos se leen con GET /v1/mails/{mail_id}/replies/{reply_id}.

Un correo recibe respuestas solo si lleva la dirección de respuesta de la plataforma, y la lleva cuando el correo no trae un Reply-To propio y hay a dónde entregar la respuesta: un webhook suscrito a mail.replied o un buzón de respuestas confirmado. Detalle en Webhooks.

Guía relacionada

• Buzón de respuestas — Reciba en un buzón suyo una copia de cada respuesta a sus correos.

Autenticación

Authorizationbearer tokenheaderobligatorio

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

X-Instance-Slugstringheaderobligatorio

Identificador de su instancia. Ver Autenticación.

Request

Path params:

mail_idstringobligatorio

Identificador del correo, el del evento mail.replied o el de GET /v1/mails.

Query params:

pageinteger

Número de página; la primera es la 1. Default: 1.

page_sizeinteger

Tamaño de página, 1–100. Default: 20.

Response

200 OKUna colección (data + pagination). Cada elemento:

reply_idstring

Identificador de la respuesta.

mail_idstring

El correo al que responde.

replied_atstring (fecha y hora UTC)

Cuándo llegó la respuesta.

from_addressstring | null

Quién respondió, en minúsculas. Puede no ser el destinatario: alguien que recibió el correo reenviado también puede responder.

is_autoboolean

Si es una respuesta automática.

is_spamboolean | null

Si el antispam la consideró spam. null en una automática, que no se analiza.

spam_scorenumber | null

Puntaje del antispam. null en una automática.

spf, dkim, dmarcstring

Resultado de la verificación de quien respondió: pass, fail, none, temperror o permerror (SPF suma softfail y neutral).

sizeinteger

Tamaño del mensaje recibido, en bytes.

Errores

Código	Cuándo
403	La API key no tiene el scope replies:read.
404	No existe un correo con ese mail_id (mail_not_found), o es anterior a la retención en línea (mail_outside_retention).

Un correo sin respuestas responde 200 con data vacío. Detalle en Errores genéricos.

Request

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

Response

{
"data": [
  {
    "reply_id": "019a3b2c-4d5e-7f60-8a1b-2c3d4e5f6a7b",
    "mail_id": "0198564e-c423-7069-8dd3-a052aeb270da",
    "replied_at": "2026-11-01T12:00:00Z",
    "from_address": "[email protected]",
    "is_auto": false,
    "is_spam": false,
    "spam_score": 0.4,
    "spf": "pass",
    "dkim": "pass",
    "dmarc": "pass",
    "size": 4821
  }
],
"pagination": {
  "page": 1,
  "page_size": 20,
  "has_more": false,
  "total_items": 1,
  "total_pages": 1
}
}