> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/api-reference-guardian/policy-data.md).

# Policy Data

## Query policy-committed VC documents.

> Returns a paginated list of Verifiable Credential documents committed by a published Guardian policy. Intentionally restricted to audit/manage roles for cross-policy access; there is no per-participant filtering.

```json
{"openapi":"3.2.0","info":{"title":"Guardian","version":"3.7.1"},"tags":[],"servers":[{"url":"/api/v1","description":"API v1"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PolicyDataQueryResponseDTO":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"Committed VC documents matching the query."},"pagination":{"$ref":"#/components/schemas/PolicyDataPaginationDTO"},"query":{"$ref":"#/components/schemas/PolicyDataQueryInfoDTO"}},"required":["data","pagination","query"]},"PolicyDataPaginationDTO":{"type":"object","properties":{"page":{"type":"number"},"pageSize":{"type":"number"},"total":{"type":"number"},"totalPages":{"type":"number"}},"required":["page","pageSize","total","totalPages"]},"PolicyDataQueryInfoDTO":{"type":"object","properties":{"policyId":{"type":"string"},"schemaName":{"type":"string"},"appliedFilters":{"type":"object","additionalProperties":true}},"required":["policyId","schemaName"]},"BadRequestErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"error":{"type":"string"}},"required":["statusCode","message"]},"UnauthorizedErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"ForbiddenErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"},"error":{"type":"string"}},"required":["statusCode","message"]},"NotFoundErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"InternalServerErrorDTO":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/policy-data/query":{"get":{"description":"Returns a paginated list of Verifiable Credential documents committed by a published Guardian policy. Intentionally restricted to audit/manage roles for cross-policy access; there is no per-participant filtering.","operationId":"PolicyDataApi_queryPolicyData","parameters":[{"name":"policyId","required":true,"in":"query","description":"MongoDB ObjectId of the published policy.","schema":{"type":"string"}},{"name":"schemaName","required":true,"in":"query","description":"Schema name as returned by GET /schema (e.g. \"MRV Data\").","schema":{"type":"string"}},{"name":"filters","required":false,"in":"query","description":"JSON-encoded filter map. Each key is a whitelisted system field or an `option.*` field. Each value is `{ \"op\": \"<operator>\", \"value\": <any> }`. Supported operators: `eq`, `ne`, `in`, `nin`, `gt`, `gte`, `lt`, `lte`, `contains` (case-insensitive partial string match). For `in`/`nin`, value must be an array. For `contains`, value must be a string. System field whitelist: owner, assignedTo, assignedToGroup, group, hederaStatus, signature, type, draft, edited, disconnected, policyId, schema, tag, messageId, topicId, hash, createDate, updateDate, option.*. Example: `{\"hederaStatus\":{\"op\":\"eq\",\"value\":\"ISSUE\"}}`","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"1-based page number (default: 1).","schema":{"type":"number"}},{"name":"pageSize","required":false,"in":"query","description":"Items per page (default: 20, max: 200).","schema":{"type":"number"}},{"name":"sort","required":false,"in":"query","description":"Field to sort by. Prefix with `-` for descending order (default: `-createDate`). Example: `createDate`, `-updateDate`, `owner`.","schema":{"type":"string"}}],"responses":{"200":{"description":"Query executed successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDataQueryResponseDTO"}}}},"400":{"description":"Invalid query parameters (unknown filter field, invalid operator, bad JSON).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestErrorDTO"}}}},"401":{"description":"Unauthorized request.\n\nUnauthorized request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedErrorDTO"}}}},"403":{"description":"Forbidden.\n\nForbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenErrorDTO"}}}},"404":{"description":"Policy or schema not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundErrorDTO"}}}},"500":{"description":"Internal server error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDTO"}}}}},"summary":"Query policy-committed VC documents.","tags":["policy-data"]}}}}
```
