Exportar actividad de no aperturas

GET/v1/activities/unopened/export

Para desarrolladores

Descripción

Exporta en CSV o JSON, sin paginar, los correos entregados que no registran aperturas. Aplica los mismos filtros y el mismo criterio que GET /v1/activities/unopened.

Guía relacionada

• Actividad de envíos — Revise aperturas, clics y rebotes de cada envío desde el panel.

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

Query params:

formatstring, enum: `csv | json`

Formato del archivo. Default: csv.

start_datestring (date, `YYYY-MM-DD`) | null

Fecha local de inicio, aplicada sobre la fecha de recepción del correo.

end_datestring (date, `YYYY-MM-DD`) | null

Fecha local de fin, aplicada sobre la fecha de recepción del correo.

tzstring (zona IANA) | null

Zona para interpretar las fechas.

msg_idstring | null

Filtra por identificador de mensaje.

mail_idstring | null

Filtra por identificador de correo.

sender_idinteger | null

Filtra por id del remitente.

recipientstring | null

Filtra por email del destinatario, con coincidencia exacta por default. Con recipient_operator=starts_with, la coincidencia pasa a ser por prefijo (ver Filtros de texto).

recipient_operatorstring, enum: `eq | starts_with`

Operador de coincidencia para recipient: eq (exacto, default) o starts_with (el destinatario empieza con el valor dado). Se ignora si recipient no está presente.

custom_msg_idstring | null

Filtra por identificador de mensaje personalizado.

custom_group_codestring | null

Filtra por código de grupo personalizado.

mail_campaign_idinteger | null

Filtra por campaña (id ≥ 1). Solo incluye los correos del envío de la campaña: sus pruebas no llevan la campaña.

send_typesarray de string, enum: `transactional | bulk | test_sandbox`

Tipos de envío a incluir (ver GET /v1/stats/overview). Para incluir varios, repita el parámetro: ?send_types=transactional&send_types=bulk. Si se omite, incluye los tres.

subjectstring | null

Filtra por asunto, con coincidencia parcial e insensible a mayúsculas (ver Filtros de texto).

Response

200 OKRespuesta en streaming, en text/csv o application/json según format. El CSV incluye BOM UTF-8 para que Excel reconozca la codificación.text/csvapplication/json

mail_id

Identificador del correo.

msg_id

Identificador del mensaje.

to

Email del destinatario.

sender

Email del remitente. Vacío en CSV (null en JSON) cuando el correo no tiene un remitente registrado.

subject

Asunto.

received_at

Fecha y hora de recepción del correo.

sent_at

Fecha y hora de entrega.

custom_msg_id

Identificador personalizado del mensaje.

custom_group_code

Código de grupo personalizado.

send_type

Tipo de envío del correo: transactional, bulk o test_sandbox, los mismos valores que acepta send_types. Un correo de prueba o del sandbox es test_sandbox aunque sea masivo.

mail_campaign_id

Identificador de la campaña a la que pertenece el correo. Vacío en CSV (null en JSON) si no es de una campaña.

Nota

Celdas que empiezan con =, +, - o @. Para que una planilla no ejecute como fórmula un texto que la contenga, el CSV antepone un apóstrofo (') a toda celda de texto que empiece con =, +, -, @, una tabulación o un retorno de carro. Lo mismo hace con los encabezados. Si un texto ya empieza con apóstrofos seguidos de uno de esos caracteres, recibe un apóstrofo más. Una celda que es solo un número, sin signo o negativo, se escribe sin cambios: -5, -1200.50. Un teléfono como +56912345678 sí lleva el apóstrofo, para que la planilla lo conserve como texto y no le quite el +. Si el archivo se abre directamente en Excel, el apóstrofo se ve dentro de la celda. Si las columnas se separan con Datos › Dividir texto en columnas (Excel para la web), o el archivo se importa en Google Sheets, el apóstrofo no se muestra y la celda presenta el valor tal como está guardado. Si procesa el archivo con un programa, quite un solo apóstrofo inicial de esas celdas. El formato JSON entrega los valores sin cambios.

Notas

• No pagina: recorre todo el rango pedido.

Request

curl -X GET "https://$API_HOST/v1/activities/unopened/export?format=csv&start_date=2026-07-01&end_date=2026-07-31" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG" \
-o unopened.csv

Response

mail_id,msg_id,to,sender,subject,received_at,sent_at,custom_msg_id,custom_group_code,send_type,mail_campaign_id
0190...,0190...,[email protected],[email protected],Hello,2026-05-08T14:22:31Z,2026-05-08T14:22:33Z,,,,