Obtener el estado de una importación

GET/v1/lists/{id}/imports/{import_id}

Para desarrolladores

Descripción

El estado de una importación: si terminó, cuántas filas quedaron en la lista y cuántas se descartaron, y por qué falló si falló. Es la URL que devuelve POST /v1/lists/{id}/imports en el header Location.

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.

import_idintegerobligatorio

Identificador de la importación.

Response

200 OKDevuelve un objeto con 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ódigo	Cuándo
404	La lista no existe (list_not_found), o la importación no existe o es de otra lista (list_import_not_found).

Notas

• Las filas leídas se reparten entre las importadas, las descartadas por un valor inválido o un campo obligatorio vacío, y las descartadas por repetidas: csv_row_count = imported_row_count + failed_row_count + duplicated_row_count.
• Para seguir una importación, consulte esta URL cada algunos segundos hasta que status sea completed o failed.

Request

curl -X GET "https://$API_HOST/v1/lists/4/imports/17" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

{
"id": 17,
"list_id": 4,
"mode": "append",
"status": "completed",
"file_name": "clientes-marzo.csv",
"file_bytes": 182344,
"encoding": "cp1252",
"delimiter": ";",
"csv_row_count": 2500,
"imported_row_count": 2480,
"failed_row_count": 15,
"duplicated_row_count": 5,
"error_message": null,
"diagnostics": null,
"created_at": "2026-10-14T12:00:00Z",
"started_at": "2026-10-14T12:00:02Z",
"finished_at": "2026-10-14T12:00:09Z"
}