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

# Search evaluation scorecard templates

`POST /hiring/evaluation-scorecard-templates/search`

## Request

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

Searches evaluation scorecard template 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

- EvaluationScorecardTemplateSearchRequest
  - `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` '/evaluationScorecardTemplate/id' | '/evaluationScorecardTemplate/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 scorecard template records

- EvaluationScorecardTemplateSearchResponse
  - `items` EvaluationScorecardTemplateSearchResponseObject[], required: Array of evaluation scorecard template objects
    - `/evaluationScorecardTemplate/id` integer: Unique identifier
    - `/evaluationScorecardTemplate/title` string: Scorecard template title
    - `/evaluationScorecardTemplate/status` 'active' | 'archived': Template status. Possible values:<br /> <ul> <li><code>active</code> – Active</li> <li><code>archived</code> – Archived</li> </ul>
    - `/evaluationScorecardTemplate/questionnaireId` number: Internal questionnaire ID associated with this scorecard template
    - `/evaluationScorecardTemplate/questionnaireForm` object: Questionnaire form definition for this scorecard template. Contains the full questionnaire structure with categories and questions. Fetched from the questionnaire service.
      - `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
    - `/evaluationScorecardTemplate/createdAt` string, date-time: Creation timestamp
    - `/evaluationScorecardTemplate/createdBy` string: Employee ID of creator<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>.
    - `/evaluationScorecardTemplate/modifiedAt` string, date-time: Last modification timestamp
    - `/evaluationScorecardTemplate/modifiedBy` string: Employee ID of last modifier<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>.
  - `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)