Skip to main content

Report status and retrieval

Steps​

  1. Call intelligenceReport(id) with the report.id from the request.
  2. Read generationStatus. Continue to poll while the value is IN_PROGRESS.
  3. When the value is SUCCESS, read the report content in the same query.
  4. When the value is ERROR, read generationErrors[].message.

Sample request​

query ReportStatus {
  intelligenceReport(id: "<report-id>") {
    id
    name
    generationStatus
    finishedAt
    generationErrors {
      message
    }
  }
}

Sample response​

{
  "data": {
    "intelligenceReport": {
      "id": "<report-id>",
      "name": "Example Industries — supplier risk",
      "generationStatus": "SUCCESS",
      "finishedAt": "2026-09-02T09:12:00Z",
      "generationErrors": []
    }
  }
}

Next call: none. Query the content fields of the report type you requested. See the IntelligenceReport interface and its implementations in the Craft API reference.

Error example​

{
  "data": {
    "intelligenceReport": {
      "id": "<report-id>",
      "generationStatus": "ERROR",
      "finishedAt": "2026-09-02T09:12:00Z",
      "generationErrors": [{ "message": "Source data unavailable for this company" }]
    }
  }
}