Saltar al contenido principal

Listar las importaciones de una lista

GET/v1/lists/{id}/imports

Para desarrolladores

Descripción​

El historial de importaciones de una lista, de la más reciente a la más antigua.

Autenticación​

Authorizationbearer tokenheaderobligatorio
API key con scope list:read. Formato: Bearer <API_KEY>.
X-Instance-Slugstringheaderobligatorio
Identificador de su instancia. Ver Autenticación.

Request​

Path params:

idintegerobligatorio
Identificador de la lista.

Query params:

pageinteger
Número de página; la primera es la 1. Default: 1.
page_sizeinteger
Tamaño de página, 1–100. Default: 20.

Response​

200 OKDevuelve una página de resultados: data con los elementos y pagination para pedir la siguiente. Cada elemento tiene los campos que siguen.
idintegersiempre presente
Identificador de la importación.
list_idintegersiempre presente
Lista a la que pertenece.
modestring, enum: `append | overwrite`siempre presente
Si el archivo se suma a la lista o la reemplaza.
statusstring, enum: `pending | processing | completed | failed`siempre presente
pending mientras espera su turno, processing mientras se lee el archivo, y completed o failed al terminar.
file_namestring | null
Nombre que tenía el archivo al subirlo.
file_bytesinteger | null
Tamaño del archivo, en bytes.
encodingstring | null
Codificación detectada en el archivo (utf-8, utf-8-sig, utf-16, cp1252).
delimiterstring | null
Separador de columnas detectado.
csv_row_countinteger | null
Filas leídas del archivo. null hasta que se procesa.
imported_row_countinteger | null
Filas que quedaron en la lista.
failed_row_countinteger | null
Filas descartadas por un valor inválido o un campo obligatorio vacío.
duplicated_row_countinteger | null
Filas descartadas por repetir el valor de una columna única.
error_messagestring | null
Por qué falló la importación, si falló.
diagnosticsobject | null
Detalle de las filas descartadas y sus motivos.
created_atstring (date-time)siempre presente
Cuándo se subió el archivo (ISO 8601, UTC).
started_atstring (date-time) | null
Cuándo empezó a leerse.
finished_atstring (date-time) | null
Cuándo terminó, haya completado o fallado.

Errores​

CódigoCuándo
404La lista no existe o fue eliminada (list_not_found).
Request
curl -X GET "https://$API_HOST/v1/lists/4/imports" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"
Response
{
"data": [
  {
    "id": 17,
    "list_id": 4,
    "mode": "append",
    "status": "pending",
    "file_name": "clientes-marzo.csv",
    "file_bytes": 182344,
    "encoding": "cp1252",
    "delimiter": ";",
    "csv_row_count": null,
    "imported_row_count": null,
    "failed_row_count": null,
    "duplicated_row_count": null,
    "error_message": null,
    "diagnostics": null,
    "created_at": "2026-10-14T12:00:00Z",
    "started_at": null,
    "finished_at": null
  }
],
"pagination": {
  "page": 1,
  "page_size": 20,
  "has_more": false,
  "total_items": 1,
  "total_pages": 1
}
}