---
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`

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.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)