---
title: "List controls filtered by connector, benchmark, tags"
method: POST
path: "/compliance/api/v3/controls"
tags: ["compliance"]
---

# List controls filtered by connector, benchmark, tags

`POST /compliance/api/v3/controls`

## Request body

- GithubComOpengovernOpengovernancePkgComplianceApiListControlsFilterRequest
  - `compliance_result_filters` GithubComOpengovernOpengovernancePkgComplianceApiComplianceResultFilters
    - `benchmarkID` string[]
    - `complianceStatus` GithubComOpengovernOpengovernancePkgComplianceApiComplianceStatus[]
    - `controlID` string[]
    - `evaluatedAt` object
      - `from` integer
      - `to` integer
    - `integrationGroup` string[]
    - `integrationID` string[]
    - `integrationType` string[]
    - `interval` string
    - `jobID` string[]
    - `lastEvent` object
      - `from` integer
      - `to` integer
    - `notIntegrationID` string[]
    - `resourceID` string[]
    - `resourceTypeID` string[]
    - `severity` TypesComplianceResultSeverity[]
    - `stateActive` boolean[]
  - `compliance_result_summary` boolean
  - `cursor` integer
  - `has_parameters` boolean
  - `integration_types` string[]
  - `list_of_tables` string[]
  - `parent_benchmark` string[]
  - `per_page` integer
  - `primary_table` string[]
  - `root_benchmark` string[]
  - `severity` string[]
  - `sort_by` string
  - `sort_order` string
  - `tags` object
  - `tags_regex` string

## Response `200`

OK

- GithubComOpengovernOpengovernancePkgComplianceApiListControlsFilterResponse
  - `items` GithubComOpengovernOpengovernancePkgComplianceApiListControlsFilterResultControl[]
    - `compliance_results_summary` object
      - `compliant_resources` integer
      - `cost_impact` number
      - `impacted_resources` integer
      - `incident_count` integer
      - `non_incident_count` integer
      - `noncompliant_resources` integer
    - `connector` string[]
    - `description` string
    - `id` string
    - `query` object
      - `list_of_tables` string[]
      - `parameters` GithubComOpengovernOpengovernancePkgComplianceApiQueryParameter[]
        - `key` string
        - `required` boolean
      - `primary_table` string
    - `severity` 'none' | 'low' | 'medium' | 'high' | 'critical'
    - `tags` object
    - `title` string
  - `total_count` integer

---

[API](https://skmtc.net/opengovern/apis/opengovernance-service-api.md) · [All operations](https://skmtc.net/opengovern/apis/opengovernance-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opengovern/opengovernance-service-api/revisions/ab05295c4094/schema)