List Campaigns

GET {{baseUrl}}/campaigns

Use this API to get a list of campaigns. This API can provide increased level of detail for each campaign for the correct provided query.

Request Params

KeyDatatypeRequiredDescription
detailstringDetermines whether slim, or increased level of detail is provided for each campaign in the returned list. Slim is the default behavior.
limitnumberMax number of results to return.
See V3 API Standard Collection Parameters for more information.
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results.
See V3 API Standard Collection Parameters for more information.
countbooleanIf true it will populate the X-Total-Count response header with the number of results that would be returned if limit and offset were ignored.

Since requesting a total count can have a performance impact, it is recommended not to send count=true if that value will not be used.

See V3 API Standard Collection Parameters for more information. | | filters | string | | Filter results using the standard syntax described in V3 API Standard Collection Parameters

Filtering is supported for the following fields and operators:

id: eq, in

name: eq, sw

status: eq, in | | sorters | string | | Sort results using the standard syntax described in V3 API Standard Collection Parameters

Sorting is supported for the following fields: name, created |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

[{"id":"078696a575e045c68d6722ccdb9f101d","name":"Role Composition Campaign","description":"A review done by a role owner.","deadline":"2020-12-25T06:00:00.468Z","type":"ROLE_COMPOSITION","status":"ERROR","emailNotificationEnabled":false,"autoRevokeAllowed":false,"recommendationsEnabled":false,"modified":"2022-08-02T20:29:51.331Z","filter":{"type":"CAMPAIGN_FILTER","id":"0fbe863c063c4c88a35fd7f17e8a3df5","name":"Test Role Composition Filter"},"sunsetCommentsRequired":true,"sourceOwnerCampaignInfo":null,"searchCampaignInfo":null,"roleCompositionCampaignInfo":{"remediatorRef":{"type":"IDENTITY","id":"7ec252acbd4245548bc25df22348cb75","name":"SailPoint Support"},"reviewerId":null,"reviewer":null,"roleIds":["b15d609fc5c8434b865fe552315fda8f"],"query":null,"description":null},"sourcesWithOrphanEntitlements":null,"mandatoryCommentRequirement":"NO_DECISIONS"},{"id":"1be8fc1103914bf0a4e14e316b6a7b7c","name":"Manager Review","description":"A review of everyone's access by their manager.","deadline":"2020-12-25T06:00:00.468Z","type":"MANAGER","status":"STAGED","emailNotificationEnabled":false,"autoRevokeAllowed":false,"recommendationsEnabled":false,"modified":"2022-08-02T19:00:34.391Z","filter":{"type":"CAMPAIGN_FILTER","id":"0fbe863c063c4c88a35fd7f17e8a3df5","name":"Test Manager Filter"},"sunsetCommentsRequired":true,"sourceOwnerCampaignInfo":null,"searchCampaignInfo":null,"roleCompositionCampaignInfo":null,"sourcesWithOrphanEntitlements":[],"mandatoryCommentRequirement":"NO_DECISIONS"},{"id":"7e1a731e3fb845cfbe58112ba4673ee4","name":"Search Campaign","description":"Search Campaign for Identities","deadline":"2022-07-26T15:42:44.000Z","type":"SEARCH","status":"ACTIVE","emailNotificationEnabled":false,"autoRevokeAllowed":false,"recommendationsEnabled":false,"modified":"2022-07-25T15:42:53.718Z","filter":{"type":"CAMPAIGN_FILTER","id":"0fbe863c063c4c88a35fd7f17e8a3df5","name":"Test Search Filter"},"sunsetCommentsRequired":true,"sourceOwnerCampaignInfo":null,"searchCampaignInfo":{"type":"IDENTITY","description":"Example of Search Campaign","reviewer":{"type":"IDENTITY","id":"7ec252acbd4245548bc25df22348cb75","name":null},"query":"user","identityIds":null,"accessConstraints":[]},"roleCompositionCampaignInfo":null,"sourcesWithOrphanEntitlements":[],"mandatoryCommentRequirement":"NO_DECISIONS"},{"id":"ad3cf3dd50394b1bad646de4bc51b999","name":"Source Owner Campaign","description":"Example for Source Owner Campaign","deadline":"2022-08-10T17:09:02.000Z","type":"SOURCE_OWNER","status":"ACTIVE","emailNotificationEnabled":true,"autoRevokeAllowed":false,"recommendationsEnabled":false,"modified":"2022-07-27T17:09:13.925Z","filter":{"type":"CAMPAIGN_FILTER","id":"0fbe863c063c4c88a35fd7f17e8a3df5","name":"Test Source Owner Filter"},"sunsetCommentsRequired":true,"sourceOwnerCampaignInfo":{"sourceIds":["2c91808781fd5aea01821200dc88318e"]},"searchCampaignInfo":null,"roleCompositionCampaignInfo":null,"sourcesWithOrphanEntitlements":[],"correlatedStatus":"CORRELATED","mandatoryCommentRequirement":"NO_DECISIONS"}]