---
title: "Search evaluations"
method: POST
path: "/hiring/evaluations/search"
tags: ["Interviews & Evaluations"]
---

# Search evaluations

`POST /hiring/evaluations/search`

Searches evaluation records using filters and returns paginated results.

<ul>
  <li>Use the <code>fields</code> parameter to specify which fields to return</li>
  <li>Use the <code>filters</code> parameter to narrow down results</li>
  <li>Use cursor-based pagination with <code>limit</code> and <code>cursor</code></li>
</ul>

<p><b>Testing notes</b>:</p>
<ul>
  <li>Use the testing widget's <b>Try It!</b> option to test this endpoint.</li>
  <li>Use the <b>Examples > Request Example</b> option to see how to initiate body parameters.</li>
</ul>

## Request body

- EvaluationSearchRequest
  - `fields` string[], required — Required list of field IDs to include in the response (1–50 fields). The property must be provided; if omitted or not provided, the API returns an error. You must explicitly choose which fields to fetch. For all available field IDs, see the <code>fields</code> object defined on each item in the 200 response schema.
  - `filters` object[]
    - `fieldId` '/evaluation/id' | '/evaluation/applicationId' | '/evaluation/status', required — Field ID to filter by
    - `operator` 'equals' | 'notEqual' | 'greaterThan' | 'lessThan', required — Filter operator. Use 'equals'/'notEqual' for exact matching. Use 'greaterThan'/'lessThan' for date range filtering.
    - `values` union[], required
      - union
        - string
        - number
  - `limit` integer
  - `cursor` string
  - `includeArchived` boolean

## Response `200`

Successfully retrieved evaluation records

- EvaluationSearchResponse
  - `items` EvaluationSearchResponseObject[], required — Array of evaluation objects
    - `/evaluation/id` integer — Unique identifier
    - `/evaluation/type` 'quick' | 'scorecard' | 'resume_screening' — Evaluation type. Possible values:<br /> <ul> <li><code>quick</code> – Quick evaluation</li> <li><code>scorecard</code> – Scorecard evaluation</li> <li><code>resume_screening</code> – Resume screening</li> </ul>
    - `/evaluation/evaluatorType` 'employee' — Type of evaluator. Currently only <code>employee</code> is supported.
    - `/evaluation/evaluatorId` string — Evaluator employee ID<br /><br />To read this employee, use <a href="https://apidocs.hibob.com/reference/post_people-identifier" target="_blank">Read company employee fields by employee ID ↗</a>.
    - `/evaluation/evaluationScorecardTemplateId` number — Evaluation scorecard template ID.<br /><br />To fetch the template, use <a href="https://apidocs.hibob.com/reference/post_hiring-evaluation-scorecard-templates-search" target="_blank">Search evaluation scorecard templates ↗</a>.
    - `/evaluation/questionnaireId` number — Internal questionnaire ID associated with this evaluation
    - `/evaluation/form` object — Questionnaire form structure with questions and submitted answers. Populated from the questionnaire service when the evaluation has an associated questionnaire.
      - `questionnaire` object — The questionnaire definition
        - `id` integer — Questionnaire ID
        - `title` string — Questionnaire title
        - `showQuestionNumbers` boolean — Whether to show question numbers
        - `items` object[] — Ordered list of categories, each containing questions.
          - `id` integer — Category ID
          - `title` string — Category title
          - `order` integer — Display order
          - `isPrivate` boolean — Whether this category is private
          - `items` object[] — Questions in this category
      - `answers` object[] — Submitted answers for the questionnaire
    - `/evaluation/answererId` string — Answerer employee ID<br /><br />To read this employee, use <a href="https://apidocs.hibob.com/reference/post_people-identifier" target="_blank">Read company employee fields by employee ID ↗</a>.
    - `/evaluation/name` string — Evaluation name
    - `/evaluation/stageId` number — Pipeline stage ID
    - `/evaluation/status` 'new' | 'in_progress' | 'scheduled_in_progress' | 'completed' | 'canceled' | 'scheduled' — Evaluation status. Possible values:<br /> <ul> <li><code>new</code> – New</li> <li><code>in_progress</code> – In progress</li> <li><code>scheduled_in_progress</code> – Scheduled in progress</li> <li><code>completed</code> – Completed</li> <li><code>canceled</code> – Canceled</li> <li><code>scheduled</code> – Scheduled</li> </ul>
    - `/evaluation/recommendation` 'pending' | 'undetermined' | 'no' | 'yes' | 'strong_yes' — Recommendation. Possible values:<br /> <ul> <li><code>pending</code> – Pending</li> <li><code>undetermined</code> – Undetermined</li> <li><code>no</code> – No</li> <li><code>yes</code> – Yes</li> <li><code>strong_yes</code> – Strong yes</li> </ul>
    - `/evaluation/recommendationComment` string — Recommendation comment
    - `/evaluation/assignedComment` string — Comment added when evaluation was assigned
    - `/evaluation/score` number — Evaluation score
    - `/evaluation/dueAt` string, date-time — Due date
    - `/evaluation/submittedAt` string, date-time — Submission timestamp
    - `/evaluation/createdAt` string, date-time — Creation timestamp
    - `/evaluation/applicationId` number — ID of the associated application.<br /><br />To fetch the application, use <a href="https://apidocs.hibob.com/reference/post_hiring-applications-search" target="_blank">Search applications ↗</a>.
    - `/evaluation/lastNotificationSentAt` string, date-time — Last notification sent timestamp
    - `/evaluation/notificationJobId` string — Internal notification job identifier
    - `/evaluation/submittedBy` string — Employee ID of the person who submitted<br /><br />To read this employee, use <a href="https://apidocs.hibob.com/reference/post_people-identifier" target="_blank">Read company employee fields by employee ID ↗</a>.
    - `/evaluation/createdBy` string — Employee ID of the person who created<br /><br />To read this employee, use <a href="https://apidocs.hibob.com/reference/post_people-identifier" target="_blank">Read company employee fields by employee ID ↗</a>.
    - `/evaluation/skillsSnapshotId` number — ID of the skills snapshot captured at the time of evaluation
  - `response_metadata` object, required
    - `next_cursor` string, nullable — Cursor for next page. Null if no more results.

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized - Invalid or missing credentials
- `403` — Forbidden - IP not allowed or feature not enabled
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/revisions/0781ebbdda91/schema)