---
title: "POST /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults"
method: POST
path: "/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults"
---

# POST /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults

`POST /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults`

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/policyStates/{policyStatesResource}/queryResults`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Queries policy states for the resources under the subscription.

## Path parameters

- `policyStatesResource` 'default' | 'latest', required
- `subscriptionId` string, required

## Query parameters

- `api-version` string, required
- `$top` integer
- `$orderby` string
- `$select` string
- `$from` string, date-time
- `$to` string, date-time
- `$filter` string
- `$apply` string
- `$skiptoken` string

## Response `200`

Query results.

- PolicyStatesQueryResults: Query results.
  - `@odata.context` string: OData context string; used by OData clients to resolve type information based on metadata.
  - `@odata.count` integer: OData entity count; represents the number of policy state records returned.
  - `@odata.nextLink` string: Odata next link; URL to get the next set of results.
  - `value` PolicyState[]: Query results.
    - `@odata.id` string: OData entity ID; always set to null since policy state records do not have an entity ID.
    - `@odata.context` string: OData context string; used by OData clients to resolve type information based on metadata.
    - `timestamp` string, date-time: Timestamp for the policy state record.
    - `resourceId` string: Resource ID.
    - `policyAssignmentId` string: Policy assignment ID.
    - `policyDefinitionId` string: Policy definition ID.
    - `effectiveParameters` string: Effective parameters for the policy assignment.
    - `isCompliant` boolean: Flag which states whether the resource is compliant against the policy assignment it was evaluated against.
    - `subscriptionId` string: Subscription ID.
    - `resourceType` string: Resource type.
    - `resourceLocation` string: Resource location.
    - `resourceGroup` string: Resource group name.
    - `resourceTags` string: List of resource tags.
    - `policyAssignmentName` string: Policy assignment name.
    - `policyAssignmentOwner` string: Policy assignment owner.
    - `policyAssignmentParameters` string: Policy assignment parameters.
    - `policyAssignmentScope` string: Policy assignment scope.
    - `policyDefinitionName` string: Policy definition name.
    - `policyDefinitionAction` string: Policy definition action, i.e. effect.
    - `policyDefinitionCategory` string: Policy definition category.
    - `policySetDefinitionId` string: Policy set definition ID, if the policy assignment is for a policy set.
    - `policySetDefinitionName` string: Policy set definition name, if the policy assignment is for a policy set.
    - `policySetDefinitionOwner` string: Policy set definition owner, if the policy assignment is for a policy set.
    - `policySetDefinitionCategory` string: Policy set definition category, if the policy assignment is for a policy set.
    - `policySetDefinitionParameters` string: Policy set definition parameters, if the policy assignment is for a policy set.
    - `managementGroupIds` string: Comma separated list of management group IDs, which represent the hierarchy of the management groups the resource is under.
    - `policyDefinitionReferenceId` string: Reference ID for the policy definition inside the policy set, if the policy assignment is for a policy set.
    - `complianceState` string: Compliance state of the resource.
    - `policyEvaluationDetails` PolicyEvaluationDetails: Policy evaluation details.
      - `evaluatedExpressions` ExpressionEvaluationDetails[]: Details of the evaluated expressions.
        - `result` string: Evaluation result.
        - `expression` string: Expression evaluated.
        - `path` string: Property path if the expression is a field or an alias.
        - `expressionValue` object: Value of the expression.
        - `targetValue` object: Target value to be compared with the expression value.
        - `operator` string: Operator to compare the expression value and the target value.
      - `ifNotExistsDetails` IfNotExistsEvaluationDetails: Evaluation details of IfNotExists effect.
        - `resourceId` string: ID of the last evaluated resource for IfNotExists effect.
        - `totalResources` integer: Total number of resources to which the existence condition is applicable.

## Other responses

- `default`: Error response describing why the operation failed.

## Changes

- **2020-05-20** (2018-07-01-preview) `90363192fcbf`: 1 info
  - added the new optional `query` request parameter `$skiptoken`

[Operation history](https://skmtc.dev/azure/apis/policystatesclient/changes/subscriptions/:subscriptionId/providers/Microsoft.PolicyInsights/policyStates/:policyStatesResource/queryResults/post.md)

---

[API](https://skmtc.dev/azure/apis/policystatesclient.md) - [All operations](https://skmtc.dev/azure/apis/policystatesclient/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/policystatesclient/revisions/b38ff3b427a5?raw)
