Exportar los contactos de un dataset

GET/v1/datasets/{id}/records/export

Para desarrolladores

Descripción

Exporta en un archivo CSV todos los contactos de un dataset, en una sola descarga y sin paginar. Sirve para llevar el dataset completo a otro sistema; para leerlo por partes, use GET /v1/datasets/{id}/records.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope dataset:read. Formato: Bearer <API_KEY>.

X-Instance-Slugstringheaderobligatorio

Identificador de su instancia. Ver Autenticación.

Request

Path params:

idintegerobligatorio

Identificador del dataset.

Response

200 OKtext/csv; charset=utf-8, con BOM UTF-8 para que las planillas reconozcan los acentos. Las columnas son, en orden:text/csv

Columna	Contenido
record_id	Identificador del registro.
created_at	Cuándo entró el contacto al dataset, en UTC (ISO 8601).
updated_at	Su última actualización, en UTC (ISO 8601).
el identificador	La columna por la que el dataset reconoce a un contacto (EMAIL, PHONE o UNIQUECODE).
el resto	Una columna por cada campo que el dataset declara, con su field_key como encabezado.

Notas

• Una celda vacía significa que el contacto no tiene ese dato. Un sí/no se escribe true o false, y un campo de selección múltiple trae sus opciones separadas por coma.
• 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.

Errores

Código	code	Cuándo
404	dataset_not_found	El dataset no existe.

El catálogo completo está en Respuestas de error.

Notas

• El archivo contiene datos personales. Cada exportación queda en el registro de actividad de la instancia, junto con la API key que la pidió.
• Un valor guardado bajo una columna que el dataset ya no declara no se exporta: el archivo describe el dataset como está declarado al momento de la descarga.
• Un contacto que entró recién por POST /v1/datasets/{id}/contacts no aparece al instante: puede tardar hasta un minuto.

Request

curl -X GET "https://cl1api.fidelizador.com/v1/datasets/7/records/export" \
-H "Authorization: Bearer <API_KEY>" \
-H "X-Instance-Slug: <slug>" \
-o contactos.csv

Response

record_id,created_at,updated_at
102,2026-05-08T14:22:31Z,2026-05-08T14:22:31Z