Obtener una queja de correo

GET/v1/mail-complaints/{mail_id}

Para desarrolladores

Descripción

Devuelve la queja asociada a un correo, a partir de su mail_id.

Guía relacionada

• Seguimiento de correo y desuscripciones — Revise en el detalle de un correo si el destinatario envió una queja y con qué motivo.

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 o GET /v1/mail-complaints.

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.

tostring | null

Email del destinatario.

senderstring | null

Email del remitente.

complained_atstring (date-time) | null

Fecha y hora de la queja.

typestring | null

Qué reportó el destinatario, ver vocabulario.

commentstring | null

Comentario asociado a la queja, si aplica.

sent_atstring (date-time) | null

Fecha y hora de entrega del correo original.

Vocabulario de type

Es la categoría que el destinatario elige en el formulario de queja.

Valor	Significado
unknown	El destinatario no eligió una categoría.
adult_content	Contenido sexualmente explícito o para adultos.
violent_or_illegal	Contenido violento, ilegal u ofensivo.
spam	Correo no deseado.
phishing_or_malware	Suplantación de identidad, malware o virus.
fraud	Información engañosa o fraudulenta.
intellectual_property	Infracción de propiedad intelectual.
other	Otra categoría, elegida por el destinatario.

Notas

• Mismos campos que GET /v1/mail-complaints.
• Ver esa tabla de campos.

Errores

Código	Cuándo
404	No existe una queja asociada a ese mail_id (mail_complaint_not_found).

Detalle en Errores genéricos.

Request

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

Response

{
"mail_id": "0190...",
"msg_id": "0190...",
"to": "[email protected]",
"sender": "[email protected]",
"complained_at": "2026-05-10T09:00:00Z",
"type": "spam",
"comment": null,
"sent_at": "2026-05-08T14:22:33Z"
}