Skip to main content

Show Tracked Job Log

GET 

/api/tracked-job-logs/:tracked_job_log

Returns a single tracked job log by ID with full progress details including batch progress, results, and status transitions.

Required scope: jobs:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

This is the poll step for asynchronous exports: a queued export responds with a tracked_job_log_id — poll this endpoint until status is COMPLETED, then read results.download_url, results.download_filename, and results.record_count to fetch the file. Downloading the file requires the scope of the exported resource (e.g. products:read for a product export).

Authentication: Requires Bearer token with the jobs:read scope.

Background report jobs (a report run or export queued to run in the background) belong to the user who started them: their results (including the download link) are returned only to that user, and other users receive 403 from Get/Retry and results: null in lists.

Request​

Responses​

OK

Response Headers
    Content-Type