---
title: "List up to 50 recent evaluations for the authenticated account"
method: GET
path: "/v1/evaluations"
---

# List up to 50 recent evaluations for the authenticated account

`GET /v1/evaluations`

## Request

- Base URL: `https://api.mcpcensus.com`
- URL: `https://api.mcpcensus.com/v1/evaluations`
- Auth: API key in header `x-api-key`

Newest first. Completed authenticated evaluations are retained for 90 days.

## Response `200`

Account-scoped evaluation list

- EvaluationList
  - `ok` unknown, required
  - `count` integer, required
  - `evaluations` EvaluationSummary[], required
    - `audit_id` string, uuid, required
    - `server_name` string, required
    - `policy_id` string, required
    - `policy_revision` integer, required
    - `decision` 'PASS' | 'REVIEW' | 'BLOCK', required
    - `decision_scope` 'public_evidence_policy', required
    - `facts_digest` string, required
    - `policy_digest` string, required
    - `decision_input_digest` string, required
    - `engine_version` string, required
    - `evaluated_at` string, date-time, required
    - `valid_until` string, date-time, required
    - `audit_signed` unknown, required

## Other responses

- `401`: Missing, invalid, or revoked account API key

---

[API](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api.md) · [All operations](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mcpcensus/apis/the-mcp-census-api/revisions/934a7da85b52?raw)