Access Reviews

List access review campaigns

Lists access review campaign executions bucketed by state. Completed and archived executions include the file IDs of their auto-generated report ZIPs (per-app CSVs, and per-app PDFs), which can be downloaded via the GET /files/{id}/download endpoint. A null file ID on a completed execution means the report is still being generated — retry shortly. Archived executions hold partial reports for campaigns that were cancelled or archived before completion. completedExecutions includes runs concluded early by an admin.

Ordering: every bucket is newest-first. Each bucket returns at most limit executions (default 100, max 1000) — a bucket holding exactly limit items may have older ones beyond it; raise limit to fetch deeper history. Use completedAfter to poll for newly completed executions — it returns only executions whose completionTime is strictly after the given timestamp.

Example — download the latest completed campaign report:

curl -H "Authorization: Bearer API_KEY" "https://api.toriihq.com/v1.0/accessReviews/campaigns?completedAfter=2026-09-01T00:00:00Z"


curl -L -H "Authorization: Bearer API_KEY" -o report.zip "https://api.toriihq.com/v1.0/files/{REPORT_ZIP_FILE_ID}/download"

  • Rate limit: 600 requests per minute
get/accessReviews/campaigns

Request

  • Base URL
    https://api.toriihq.com/v1.0
  • Auth
    API key in header Authorization

Query parameters

limitinteger

Maximum executions returned per bucket

completedAfterstring date

Return only completed executions whose completionTime is after this timestamp

Response

Access Review Campaigns

Example response

{
  "activeExecutions": [
    {
      "id": 456,
      "idCampaign": 123,
      "name": "Access review September 2026"
    }
  ],
  "completedExecutions": [
    {
      "id": 456,
      "idCampaign": 123,
      "name": "Access review September 2026",
      "reportZipFileId": 1372203,
      "reportZipPdfFileId": 1372204
    }
  ],
  "archivedExecutions": [
    {
      "id": 456,
      "idCampaign": 123,
      "name": "Access review August 2026",
      "reportZipFileId": 1372203,
      "reportZipPdfFileId": 1372204
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.