Skip to main content

Bulk Operation Progress

GET 
/api/faire/instances/:integrationInstance/products/bulk-progress/:trackedJobLogId

Returns the live progress of a BulkFaireProductOperationTrackedJob. Returns the standard TrackedJobLogResource shape — same as the global Job Progress Tray polls. Poll this endpoint while the job runs; progress_percentage and results update as the job processes batches.

Path Parameters:

  • integrationInstance (required) - The ID of the Faire integration instance.
  • trackedJobLogId (required) - The tracked job log ID returned by the bulk-tracked dispatch.

Response (200): A standard TrackedJobLogResource. Key fields for a Faire bulk job:

  • data.id - Tracked job log ID.
  • data.status - One of pending, processing, completed, failed, cancelled.
  • data.progress_percentage - 0-100 (or null until the job starts).
  • data.message - Latest status message from the job.
  • data.results - When completed, contains { action, total, processed, failed, skipped, started_at, completed_at }. Errors populate results.error.

Errors:

  • 404 when the tracked job log ID does not exist.

Request​

Responses​

Successful response