JUjumpcloud
Access Certification

Get campaign run

Returns details for a single campaign run, including review window dates, progress percentage, remediation status, and scope information. Works for active, closed, and canceled runs.

Required permission: accesscertification or accesscertification.readonly

get/api/v2/access-certification/campaign-runs/{runId}

Request

Path parameters

runIdstring required

Campaign run public identifier (hex-encoded BSON ObjectID stored as object_id).

Response

Campaign run retrieved successfully

runIdstring required
campaignIdstring required
campaignNamestring required
campaignDescriptionstring

Campaign description from the run config snapshot

runNumberinteger required
status'active' | 'closed' | 'canceled' required

Status of a campaign run in list responses

scopeType'application' | 'group' required

What the campaign reviews — an SSO application or a user group

scopeTargetIdstring required

Application or user group object ID from the run snapshot or campaign scope

reviewerType'administrator' | 'systemuser'

Primary reviewer type from the campaign's reviewer chain

reviewWindowStartstring date-time required
reviewWindowEndstring date-time required
reviewProgressPercentinteger required
remediationStatus'not_started' | 'no_action' | 'in_progress' | 'scheduled' | 'completed' | 'failed' | 'canceled'

Overall remediation status for a campaign run. Reflects the campaign's remediation policy and per-identity progress — not review completion percentage alone.

  • no_action — Remediation policy does not require automated action on revoke
  • failed — Deprecated at campaign level; per-identity failures surface on review items while process completion uses completed
closeReasonstring

Reason recorded when the run was closed or canceled

activatedAtstring date-time
closedAtstring date-time
materializationStatus'in_progress' | 'complete' | 'failed'

Cohort materialization progress while review items are created at activate

reviewItemsMaterializedinteger

Review items materialized so far for this run

requireJustificationboolean

Effective require-justification for this run's reviewer chain

allowReassignboolean

Effective allow-reassign for this run's reviewer chain

auditReportStatus'generating' | 'exports_ready' | 'failed'

Audit artifact status for campaign list and detail UIs (maps from audit_artifacts)

Changes

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