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

{
  "errorCap": 1,
  "items": [
    {
      "message": "<string>",
      "row": 1,
      "field": "<string>"
    }
  ],
  "storedErrors": 1,
  "totalErrors": 1,
  "truncated": true
}

Authorizations

Authorization · string · header · required

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

Path Parameters

contextId · string<uuid> · required

Context ID

jobId · string<uuid> · required

Job ID

Response

200

application/json

OK

errorCap · integer<int64> · required

Maximum number of row errors stored per job

Required range: x >= 0

Example:

100

items · object[] | null · required

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

Maximum array length: 100

Show child attributes

storedErrors · integer<int64> · required

Number of row errors actually stored for this job

Required range: x >= 0

Example:

100

totalErrors · integer<int64> · required

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

Required range: x >= 0

Example:

1000

truncated · boolean · required

True when more rows failed than were stored

Example:

true