KintsugiKintsugi

Get a report job's status

GET/reports/jobs/{report_job_id}

Get the status of a report job you started. Searched across every organization your credential owns, so no selector is needed for a known id. A job you do not own answers 404, identical to one that does not exist.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

report_job_idstringRequired

Id of the report job.

Response

reportJobIdstringRequired

Id of the report job.

statusPublicReportJobStatusEnumRequired

Current lifecycle state. Once READY, fetch GET /reports/jobs/{reportJobId}/download for a download link.

Available options:QUEUEDPROCESSINGREADYFAILED
errorMessagestring

Why the job failed. Null unless status is FAILED.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

422

Validation Error

cURL
GET /reports/jobs/{report_job_id}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/reports/jobs/{report_job_id}
Response
{
"reportJobId": "a1b2c3d4-e5f6-7890",
"status": "QUEUED",
"errorMessage": "error message"
}
Get a report job's status (2026-07-21) | Kintsugi API Reference