List risks for an audit
Retrieves risk population data for an audit.
This endpoint provides access to the risk records visible to auditors
during an audit engagement. Risk data is scoped to a specific risk
assessment snapshot identified by the snapshotId parameter.
Supports filtering by:
search: Searches risk scenario descriptions (case-insensitive)
Results are sorted by identified date (newest first) by default.
Use orderBy and orderDirection to customize sorting.
Sort parameters must remain consistent across paginated requests.
Uses cursor-based pagination. To paginate:
- Make initial request with desired
pageSize - Check
results.pageInfo.hasNextPage - Use
results.pageInfo.endCursoraspageCursorfor next request
Supports audits with one or more program segments. Audits with system segments are not supported by this endpoint.
Only Controlled Audit View (CAV) audits are supported. Full Audit View
audits are rejected with 403. Returns 403 if the customer has not made
this population page visible to auditors. Also returns 403 if the
snapshot is not shared with auditors, and 404 if the snapshot does not
exist. Use snapshot IDs from GET /audits/{auditId}/risks/snapshots,
which lists only snapshots shared with auditors.
Rate limit: 10 requests / minute.
Authorizations
Path Parameters
Query Parameters
Pagination cursor from previous response A marker or pointer, telling the API where to start fetching items for the subsequent page in a paginated dataset. Note that the requested page will not include the item that corresponds to this cursor but will start from the one immediately after this cursor.
Field to sort results by. Allowed: "riskId", "riskScenario", "inherentRisk", "treatment", "residualRisk", "reviewStatus", "owner", "categories", "ciaCategories", "identified". Default: "identified"
inherentRisk, riskId, riskScenario, treatment, residualRisk, reviewStatus, owner, categories, ciaCategories, identified