Get Compliance Statistics Breakdown - GET

GET 
/compliance/posture

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Returns a breakdown of the passed/failed statistics and associated policies for compliance standards, requirements, and sections. Also returns a summary for all compliance standards.

info

Replacement  Endpoint: Get Compliance Statistics Breakdown V2 - GET

note

This endpoint will only be able to access data from the past 1 year. This change is implemented to optimize system performance and reduce data storage requirements.

Request

Query Parameters

timeType stringrequired

Possible values: [relative]

Time type

timeAmount stringrequired

Number of time units

timeUnit stringrequired

Possible values: [minute, hour, day, week, month, year]

Time unit

cloud.account string

Cloud account

cloud.type string

Cloud type

cloud.region string

Cloud region

policy.complianceStandard string

Policy compliance standard name

policy.complianceRequirement string

Policy compliance requirement name

policy.complianceSection string

Policy compliance section ID

Responses

200

success

application/json; charset=UTF-8

Schema

Schema

complianceDetails object[]
List of compliance detail
Array [
assignedPolicies int32
Number of policies assigned to the Compliance Standard/Requirement/Section
criticalSeverityFailedResources int64
Number of Compliance Standard/Requirement/Section Scanned Resources failing critical severity policies
default boolean
Is System Default
description string
Description of Compliance Standard/Requirement/Section
failedResources int64
Number of failing Compliance Standard/Requirement/Section Scanned Resources
highSeverityFailedResources int64
Number of Compliance Standard/Requirement/Section Scanned Resources failing high severity policies
id string
ID of Compliance Standard/Requirement/Section
informationalSeverityFailedResources int64
Number of Compliance Standard/Requirement/Section Scanned Resources failing informational severity policies
lowSeverityFailedResources int64
Number of Compliance Standard/Requirement/Section Scanned Resources failing low severity policies
mediumSeverityFailedResources int64
Number of Compliance Standard/Requirement/Section Scanned Resources failing medium severity policies
name string
Name of Compliance Standard/Requirement/Section
passedResources int64
Number of Passing Compliance Standard/Requirement/Section Scanned Resources
totalResources int64
Total number of Compliance Standard/Requirement/Section Scanned Resources
]
requestedTimestamp int64

Requested timestamp

requirementSummaries object[]
List of requirement summaries
Array [
id string
Compliance Requirement ID
name string
Compliance Requirement name
sectionSummaries object[]
Section Summary list for the compliance requirement
Array [
failedResources int64
Number of failed compliance section scanned resources
id string
Compliance section ID
name string
Compliance section name
passedResources int64
Number of passed compliance section scanned resources
totalResources int64
Total number of compliance section scanned resources
]
]
summary object

Model for Compliance Posture Summary

criticalSeverityFailedResources int64

Number of scanned compliance resources whose highest policy failure is critical

failedResources int64

Number of failed scanned compliance resources

highSeverityFailedResources int64

Number of scanned compliance resources that failed high severity policies

informationalSeverityFailedResources int64

Number of scanned compliance resources whose highest policy failure is informational

lowSeverityFailedResources int64

Number of scanned compliance resources whose highest policy failure is low

mediumSeverityFailedResources int64

Number of scanned compliance resources whose highest policy failure is medium

passedResources int64

Number of passed scanned compliance resources

timestamp int64

Timestamp

totalResources int64

Total number of scanned compliance resources

timestamp int64

Timestamp

Example (from schema)

{
  "complianceDetails": [
    {
      "assignedPolicies": 0,
      "criticalSeverityFailedResources": 0,
      "default": true,
      "description": "string",
      "failedResources": 0,
      "highSeverityFailedResources": 0,
      "id": "string",
      "informationalSeverityFailedResources": 0,
      "lowSeverityFailedResources": 0,
      "mediumSeverityFailedResources": 0,
      "name": "string",
      "passedResources": 0,
      "totalResources": 0
    }
  ],
  "requestedTimestamp": 0,
  "requirementSummaries": [
    {
      "id": "string",
      "name": "string",
      "sectionSummaries": [
        {
          "failedResources": 0,
          "id": "string",
          "name": "string",
          "passedResources": 0,
          "totalResources": 0
        }
      ]
    }
  ],
  "summary": {
    "criticalSeverityFailedResources": 0,
    "failedResources": 0,
    "highSeverityFailedResources": 0,
    "informationalSeverityFailedResources": 0,
    "lowSeverityFailedResources": 0,
    "mediumSeverityFailedResources": 0,
    "passedResources": 0,
    "timestamp": 0,
    "totalResources": 0
  },
  "timestamp": 0
}

400

bad_request

Loading...