> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a human review set by ID



## OpenAPI

````yaml get /v2/human-eval-sets/{id}
openapi: 3.1.0
info:
  title: orq.ai API
  version: '2.0'
  description: orq.ai API documentation
servers:
  - url: https://api.orq.ai
security:
  - ApiKey: []
tags:
  - description: List models available through the AI Router.
    name: Models
  - name: Guardrail Rules
  - name: Policies
  - name: Routing Rules
  - name: API keys
    description: >-
      API keys authenticate programmatic access to the workspace. The unified
      key model exposes opaque tokens, per-domain access grants, and budget /
      rate-limit constraints (see ADR 0001 and ADR 0002).
  - name: Budgets
    description: >-
      Budgets govern spend, token usage, and request rate across six scopes:
      workspace, project, identity, api-key, provider, and model. A budget is
      hierarchical and defense-in-depth — every applicable budget is a hard
      gate, and the most restrictive one wins per dimension (see ADR 0007).
  - name: Documentation
    description: >-
      Search the orq.ai documentation. Proxies the workspace's query to the
      hosted docs search index.
  - name: Files
    description: File upload and retrieval operations.
  - name: Identities
    description: >-
      Identities represent end users from your system for usage and engagement
      tracking.
  - name: Projects
    description: Projects organize resources within a workspace
  - name: Skills
    description: >-
      Skills are modular instructions you can use to codify processes and
      conventions
  - name: Responses
  - description: >-
      Run agents on a cadence — cron, interval, or one-off. Minimum firing
      interval is 1 hour.
    name: Agent Schedules
  - name: Embeddings
  - name: Reporting
    description: >-
      GenAI reporting API over canonical analytics rollups. Accepts a metric
      name, time range, grain, group-by, and filters; returns a typed time
      series and optional totals.
externalDocs:
  url: https://docs.orq.ai
  description: orq.ai Documentation
paths:
  /v2/human-eval-sets/{id}:
    get:
      tags:
        - Human Review Sets
      summary: Get a human review set by ID
      parameters:
        - schema:
            type: string
            description: The ID of the human review set to retrieve
          required: true
          description: The ID of the human review set to retrieve
          name: id
          in: path
      responses:
        '200':
          description: Successfully retrieved the human review set
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      _id:
                        type: string
                        format: ulid
                        pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
                        readOnly: true
                        description: The id of the resource
                      display_name:
                        type: string
                        minLength: 1
                        maxLength: 255
                        description: Display name of the human review set
                      description:
                        type: string
                        description: Detailed description of the human review set
                      human_eval_ids:
                        type: array
                        items:
                          type: string
                          format: ulid
                          pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
                          readOnly: true
                          description: The id of the resource
                        minItems: 1
                        description: >-
                          Array of human review IDs to be applied to matching
                          spans
                      workspace_id:
                        type: string
                      project_id:
                        anyOf:
                          - type: string
                            format: uuid
                            pattern: >-
                              ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
                            readOnly: true
                            description: The id of the resource
                          - type: string
                            format: ulid
                            pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
                            readOnly: true
                            description: The id of the resource
                        description: >-
                          Optional project ID to scope this human review set to
                          a specific project
                      created_by_id:
                        type: string
                      updated_by_id:
                        type: string
                      created:
                        anyOf:
                          - format: date-time
                            type: string
                          - format: date-time
                            type: string
                        default: '2026-06-10T10:08:14.953Z'
                        readOnly: true
                        format: date-time
                        description: The date and time the resource was created
                      updated:
                        anyOf:
                          - type: string
                            format: date-time
                            default: '2026-06-10T10:08:14.954Z'
                          - format: date-time
                            type: string
                        readOnly: true
                        format: date-time
                        description: The date and time the resource was last updated
                      filter_type:
                        type: string
                        enum:
                          - span_type
                      filter_values:
                        type: array
                        items:
                          type: string
                        minItems: 1
                        description: Array of span types to match
                    required:
                      - _id
                      - display_name
                      - human_eval_ids
                      - workspace_id
                      - filter_type
                      - filter_values
                  - type: object
                    properties:
                      _id:
                        type: string
                        format: ulid
                        pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
                        readOnly: true
                        description: The id of the resource
                      display_name:
                        type: string
                        minLength: 1
                        maxLength: 255
                        description: Display name of the human review set
                      description:
                        type: string
                        description: Detailed description of the human review set
                      human_eval_ids:
                        type: array
                        items:
                          type: string
                          format: ulid
                          pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
                          readOnly: true
                          description: The id of the resource
                        minItems: 1
                        description: >-
                          Array of human review IDs to be applied to matching
                          spans
                      workspace_id:
                        type: string
                      project_id:
                        anyOf:
                          - type: string
                            format: uuid
                            pattern: >-
                              ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
                            readOnly: true
                            description: The id of the resource
                          - type: string
                            format: ulid
                            pattern: ^[0-9A-HJKMNP-TV-Z]{26}$
                            readOnly: true
                            description: The id of the resource
                        description: >-
                          Optional project ID to scope this human review set to
                          a specific project
                      created_by_id:
                        type: string
                      updated_by_id:
                        type: string
                      created:
                        anyOf:
                          - format: date-time
                            type: string
                          - format: date-time
                            type: string
                        default: '2026-06-10T10:08:14.953Z'
                        readOnly: true
                        format: date-time
                        description: The date and time the resource was created
                      updated:
                        anyOf:
                          - type: string
                            format: date-time
                            default: '2026-06-10T10:08:14.954Z'
                          - format: date-time
                            type: string
                        readOnly: true
                        format: date-time
                        description: The date and time the resource was last updated
                      filter_type:
                        type: string
                        enum:
                          - name
                      filter_value:
                        type: string
                        minLength: 1
                        description: Name pattern to match
                    required:
                      - _id
                      - display_name
                      - human_eval_ids
                      - workspace_id
                      - filter_type
                      - filter_value
components:
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: JWT

````