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

# Search evaluations

`POST /hiring/evaluations/search`

## Request

- Base URL: `https://api.hibob.com/v1`
- URL: `https://api.hibob.com/v1/hiring/evaluations/search`
- Auth: HTTP basic

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.dev/hibob/apis/bob-hiring-api.md) - [All operations](https://skmtc.dev/hibob/apis/bob-hiring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hibob/apis/bob-hiring-api/revisions/c758e371fc83?raw)