---
title: "Search all compliance plan instances"
method: POST
path: "/configuration_manager/search/compliance_plan_instances"
tags: ["Configuration Manager"]
---

# Search all compliance plan instances

`POST /configuration_manager/search/compliance_plan_instances`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/configuration_manager/search/compliance_plan_instances`
- Auth: none declared

Gets a list of all Compliance Plan Instances that match the search criteria.

## Request body

- object
  - `searchParams` ConfigurationManagerSearchCompliancePlanInstancesPostRequestBodyContentApplicationJsonSchemaSearchParams
    - `instanceId` string: ID of the instance to fetch
    - `planId` string: Fetches all instances with this planId
    - `planName` string: Fetches all instances with this planName
    - `description` string: Filter by description of the plan instance.
    - `status` 'running' | 'complete' | 'paused' | 'error' | 'canceled': Filter by status of the Job pertainig to the plan instance.
    - `dateRange` unknown[]: An array containing the start and end date. Index 0 = start date, index 1 = end date.
      - unknown
    - `start` integer
    - `limit` integer
    - `sort` ConfigurationManagerSearchCompliancePlanInstancesPostRequestBodyContentApplicationJsonSchemaSearchParamsSort
      - `started` '-1' | '1'
      - `jobStatus` '-1' | '1'
      - `name` '-1' | '1'

## Response `200`

List of Compliance Plan Instances that match the search criteria

- ConfigurationManagerSearchCompliancePlanInstancesResponse200
  - `totalCount` number, double
  - `groups` unknown[]
    - unknown

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Configuration Manager` added
  - api tag `configurationManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/configuration_manager/search/compliance_plan_instances/post.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)