Skip to main content
Version: Latest (4.0.6)

List campaigns (graph filter)

POST 
/recertification/graph/campaigns

Returns a paginated, filterable list of campaigns.

Roles: any recertification role, or cidaas:campaign_read scope.

Access scoping:

  • Management roles (CAMPAIGN_ADMIN/CAMPAIGN_MANAGER, CAMPAIGN_READ/CAMPAIGN_VIEWER, CAMPAIGN_CREATE, CAMPAIGN_DELETE) and scope-based callers: see all campaigns. Optional reviewers filter narrows results.
  • All other authenticated users: automatically scoped to campaigns where the token subject is listed in groups[].reviewers; cannot filter for other reviewer subs (403).

Filter validation: dateField or filters required. Indexed filter fields: groups.groupId, campaignName, status, strategy. Sort fields: createdTime, updatedTime only. Max 50 reviewer subs in reviewers array.

Returns 200 with { "count": 0, "campaigns": [] } when no campaigns match.

Request​

Responses​

Matching campaigns