---
title: "Get all human review sets"
method: GET
path: "/v2/human-eval-sets"
tags: ["Human Review Sets"]
---

# Get all human review sets

`GET /v2/human-eval-sets`

## Query parameters

- `project_id` union — Optional project ID to filter human review sets by project
  - string
  - string, ulid — The id of the resource

## Response `200`

Successfully retrieved all human review sets

- union[]
  - union
    - object
      - `_id` string, ulid, required — The id of the resource
      - `display_name` string, required — Display name of the human review set
      - `description` string — Detailed description of the human review set
      - `human_eval_ids` string[], required — Array of human review IDs to be applied to matching spans
      - `workspace_id` string, required
      - `project_id` union — Optional project ID to scope this human review set to a specific project
        - string
        - string, ulid — The id of the resource
      - `created_by_id` string
      - `updated_by_id` string
      - `created` union — The date and time the resource was created
        - string, date-time
        - string, date-time
      - `updated` union — The date and time the resource was last updated
        - string, date-time
        - string, date-time
      - `filter_type` 'span_type', required
      - `filter_values` string[], required — Array of span types to match
    - object
      - `_id` string, ulid, required — The id of the resource
      - `display_name` string, required — Display name of the human review set
      - `description` string — Detailed description of the human review set
      - `human_eval_ids` string[], required — Array of human review IDs to be applied to matching spans
      - `workspace_id` string, required
      - `project_id` union — Optional project ID to scope this human review set to a specific project
        - string
        - string, ulid — The id of the resource
      - `created_by_id` string
      - `updated_by_id` string
      - `created` union — The date and time the resource was created
        - string, date-time
        - string, date-time
      - `updated` union — The date and time the resource was last updated
        - string, date-time
        - string, date-time
      - `filter_type` 'name', required
      - `filter_value` string, required — Name pattern to match

## Changes

> 261 revisions in range; 73 not diffed.

- **2026-09-02** `c4473310c013` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `items/` response property `oneOf` list for the response status `200`
- **2026-09-02** `cb6c448ef637` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `items/` response property `oneOf` list for the response status `200`
- **2026-09-01** `359a7831a2f0` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `items/` response property `oneOf` list for the response status `200`
- **2026-09-01** `66b8a4902911` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `items/` response property `oneOf` list for the response status `200`
- **2026-09-01** `081200e02fe0` — 1 breaking, 1 info
  - added `subschema #1, subschema #2` to the `items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2` from the `items/` response property `oneOf` list for the response status `200`

[Full history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/human-eval-sets/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/4a39391f62da/schema)