List per-row import errors for a job

Returns the stored per-row parse/normalization errors for an ingestion job (capped at 100 per job), with the uncapped failure total and truncation accounting. Lets clients explain failed or partially-failed imports.

GET /v1/imports/contexts/{contextId}/jobs/{jobId}/errors

List per-row import errors for a job

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/jobs/{jobId}/errors \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "errorCap": 100,
  "items": [
    {
      "message": "invalid decimal",
      "row": 15,
      "field": "amount"
    }
  ],
  "storedErrors": 100,
  "totalErrors": 1000,
  "truncated": true
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Parámetros de ruta

contextId · string<uuid> · requerido

Context ID

jobId · string<uuid> · requerido

Job ID

Respuesta

200

application/json

OK

errorCap · integer<int64> · requerido

Maximum number of row errors stored per job

Rango requerido: x >= 0

Ejemplo:

100

items · object[] | null · requerido

Stored row errors ordered by row number (capped at errorCap per job)

Maximum array length: 100

Show child attributes

storedErrors · integer<int64> · requerido

Number of row errors actually stored for this job

Rango requerido: x >= 0

Ejemplo:

100

totalErrors · integer<int64> · requerido

Total number of failed rows for the job (may exceed storedErrors)

Rango requerido: x >= 0

Ejemplo:

1000

truncated · boolean · requerido

True when more rows failed than were stored

Ejemplo:

true