> ## Documentation Index > Fetch the complete documentation index at: https://docs.trusys.ai/llms.txt > Use this file to discover all available pages before exploring further. # List guardrail evaluation history > Returns paginated guardrail validation records for an application within a time range. **Filters**: - `passStatus` — `success` or `error` - `stage` — `input` or `output` - `category` — validator category (for example `pii`, `prompt-injection`) - `search` — free-text search across records ## OpenAPI ````yaml /openapi.json get /applications/{applicationId}/guardrails/evaluations openapi: 3.0.0 info: title: Trusys API version: 1.0.0 description: >- Programmatic access to Trusys for integrating AI quality monitoring, evaluation, and guardrails into your own systems — without using the Trusys UI. **Typical integration flow** 1. `POST /applications` — register your application and get an id. 2. `PUT /applications/{id}/monitoring` and/or `PUT /applications/{id}/guardrails` — configure which metrics, security plugins, and guardrails apply. 3. `POST /applications/{id}/evaluations` — submit prompt/response traces to be scored as your application runs. 4. `GET /applications/{id}/traces`, `GET /applications/{id}/evaluations`, and `POST /applications/{id}/widget-data` — pull results, trends, and dashboard-equivalent chart data back into your own tools. All requests require an `x-api-key` header (see Authentication). All timestamps are ISO 8601 UTC. Paginated endpoints default to 20 items per page (max 100). servers: - url: https://backend.trusys.ai/api/external security: - ApiKeyAuth: [] paths: /applications/{applicationId}/guardrails/evaluations: get: tags: - Guardrails summary: List guardrail evaluation history description: >- Returns paginated guardrail validation records for an application within a time range. **Filters**: - `passStatus` — `success` or `error` - `stage` — `input` or `output` - `category` — validator category (for example `pii`, `prompt-injection`) - `search` — free-text search across records operationId: listGuardrailEvaluations parameters: - $ref: '#/components/parameters/applicationId' - $ref: '#/components/parameters/start' - $ref: '#/components/parameters/end' - $ref: '#/components/parameters/page' - $ref: '#/components/parameters/limit' - name: passStatus in: query required: false schema: type: string enum: - success - error - name: stage in: query required: false schema: type: string enum: - input - output - name: category in: query required: false schema: type: string - name: search in: query required: false schema: type: string responses: '200': description: Paginated guardrail evaluation records. content: application/json: schema: $ref: '#/components/schemas/PaginatedResultsResponse' '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: parameters: applicationId: name: applicationId in: path required: true schema: type: string format: uuid description: >- Unique identifier (UUID) of the application. Returned by `POST /applications`. start: name: start in: query required: true schema: type: string format: date-time description: >- Start of the time range, inclusive. ISO 8601 datetime in UTC (for example `2026-07-01T00:00:00.000Z`). example: '2026-07-01T00:00:00.000Z' end: name: end in: query required: true schema: type: string format: date-time description: >- End of the time range, inclusive. Must be the same as or after `start`. ISO 8601 datetime in UTC. example: '2026-07-02T23:59:59.999Z' page: name: page in: query required: false schema: type: integer minimum: 1 default: 1 description: Page number for paginated results (1-based). limit: name: limit in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 20 description: Maximum number of applications per page (max 100). schemas: PaginatedResultsResponse: type: object properties: success: type: boolean example: true data: type: object properties: results: type: array items: type: object additionalProperties: true count: type: integer description: Total matching rows. page: type: integer limit: type: integer ValidationErrorResponse: type: object description: Returned when request body or query parameters fail validation. properties: success: type: boolean example: false message: type: string example: Invalid request body description: Summary of the validation failure. errors: type: array description: Per-field validation errors. items: type: object properties: path: type: string description: >- JSON path to the invalid field (for example `traces.0.prompt`). message: type: string description: Why the field failed validation. ErrorResponse: type: object description: Standard error envelope for non-validation failures. properties: success: type: boolean example: false description: Always `false` for errors. message: type: string description: Human-readable explanation of the error. required: - success - message responses: ValidationError: description: >- The request body or query parameters are invalid. See the `errors` array for field-level detail. content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' example: success: false message: Invalid request body errors: - path: name message: name is required Unauthorized: description: >- The API key is missing, invalid, or revoked. Verify the `x-api-key` header and that the key is active in Trusys settings. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: message: Error while verifying api key NotFound: description: The requested resource does not exist, or your API key cannot access it. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false message: Application not found securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Trusys API key. Create and manage keys in the Trusys UI under **Settings → API Keys**. Include the key on every request: ``` x-api-key: ``` ````