Obtener una queja de correo

GET/v1/mail-complaints/{mail_id}

Descripción

Retorna el reporte de queja asociado a un mail específico.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope mail:read. Formato: Bearer FD.<key_id>.<token>.

X-Instance-Slugstringheaderobligatorio

Request

Path params:

mail_idstring

Identificador del mail.

Response

200 OKDevuelve un objeto con los campos que siguen.

mail_idstringobligatorio

Identificador del mail.

msg_idstring | null

Identificador del mensaje lógico.

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 mail original.

Vocabulario de type

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

Valor	Significado
unknown	El proveedor no informó 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 informada por el proveedor.

Nota

Mismos campos que GET /v1/mail-complaints.

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": "alice@example.com",
"sender": "newsletter@example.com",
"complained_at": "2026-05-10T09:00:00Z",
"type": "spam",
"comment": null,
"sent_at": "2026-05-08T14:22:33Z"
}