Saltar al contenido principal

Exportar actividad de envíos

GET/v1/activities/sent/export

Para desarrolladores

Descripción​

Exporta en CSV o JSON, sin paginar, el listado completo de correos enviados en el rango pedido.

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.
end_datestring (date, `YYYY-MM-DD`) | null
Fecha local de fin.
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).
statusinteger | null
Filtra por estado de entrega (1–7: 1=received, 2=queued, 3=sent, 4=dropped, 5=deferred, 6=bounced, 7=onhold).
openedstring, enum: `all | opened | unopened` | null
opened: solo con aperturas. unopened: entregados sin aperturas. Con all, o si se omite, no se filtra.

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.
queued_at
Fecha y hora de encolado en el MTA.
sent_at
Fecha y hora de entrega al MX del destinatario.
schedule_at
Fecha y hora programada de envío. Hoy siempre es null, porque el envío programado no está disponible.
delay
Demora de entrega en segundos.
opens
Cantidad de aperturas.
clicks
Cantidad de clicks.
custom_msg_id
Identificador personalizado del mensaje.
custom_group_code
Código de grupo personalizado.
Notas
  • Las columnas (CSV) y los campos (JSON) aparecen en el orden de esta tabla.
  • 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
Request
curl -X GET "https://$API_HOST/v1/activities/sent/export?format=csv&start_date=2026-07-01&end_date=2026-07-31" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG" \
-o sent.csv
Response
mail_id,msg_id,to,sender,subject,received_at,queued_at,sent_at,schedule_at,delay,opens,clicks,custom_msg_id,custom_group_code
0190...,0190...,[email protected],[email protected],Hello,2026-05-08T14:22:31Z,2026-05-08T14:22:32Z,2026-05-08T14:22:33Z,,2.4,1,0,,