Saltar al contenido principal

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​

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

Columnas: mail_id, msg_id, to, sender, subject, received_at, sent_at, custom_msg_id, custom_group_code.

Significado de cada columna: ver la tabla de GET /v1/activities/unopened.

mail_idstringsiempre presente
Identificador del correo.
msg_idstring | null
Identificador del mensaje.
tostringsiempre presente
Email del destinatario.
senderstring | null
Email del remitente.
subjectstringsiempre presente
Asunto.
received_atstring (date-time) | null
Fecha y hora de recepción del correo.
sent_atstring (date-time) | null
Fecha y hora de entrega.
custom_msg_idstring | null
Identificador personalizado del mensaje.
custom_group_codestring | null
Código de grupo personalizado.
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
0190...,0190...,[email protected],[email protected],Hello,2026-05-08T14:22:31Z,2026-05-08T14:22:33Z,,