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
Request
- Base URLhttps://api.toriihq.com/v1.0
- AuthAPI key in header Authorization
Query parameters
Maximum executions returned per bucket
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.