Skip to main content
GET
/
batch-import
/
user-event-jobs
/
{jobId}
/
failures
User-event batch failures
curl --request GET \
  --url http://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures \
  --header 'Authorization: Bearer <token>'

​
Endpoints

GET https://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures.csv
GET https://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures
  • …/failures.csv → CSV download
  • …/failures → JSON

​
Authentication

Authorization: Bearer YOUR_API_KEY
Requires at least one of: transactions:create, entities:bulk_import, events:create.

​
HTTP responses

StatusWhen
200Job found
401Not authenticated
403Missing permission
404Job not found

​
CSV columns

ColumnDescription
row_keySource row id (e.g. row_5 = CSV line 5)
codeStable failure code — catalog
errorHuman-readable message

​
JSON response

Same envelope as Transaction failures with kind: user_event_batch: 
{
  "success": true,
  "jobId": "…",
  "kind": "user_event_batch",
  "status": "completed",
  "totalItems": 50,
  "succeeded": 49,
  "failed": 1,
  "skipped": 0,
  "failures": [
    {
      "rowKey": "row_5",
      "code": "VALIDATION_ERROR",
      "message": "Required field empty"
    }
  ],
  "truncated": false,
  "failuresTotal": 1
}
Typical codes: VALIDATION_ERROR, ENTITY_NOT_FOUND, PROCESSING_ERROR. See also: Import user events, Failure codes.