--- updatedAt: 2026-05-20T09:18:41.000Z --- Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further. # Search evaluations Searches evaluation records using filters and returns paginated results.

Testing notes:

# OpenAPI definition ```json { "openapi": "3.1.1", "info": { "title": "Bob Hiring API", "description": "Public API for accessing Bob Hiring data including Job Openings, Candidates, and Applications.", "license": { "name": "Proprietary", "url": "https://apidocs.hibob.com/docs/api-terms-of-use" }, "contact": { "name": "Hi Bob, Inc." }, "version": "1.0.0" }, "servers": [ { "url": "https://api.hibob.com/v1", "description": "Production" }, { "url": "https://api.sandbox.hibob.com/v1", "description": "Sandbox" } ], "x-readme": { "metrics-enabled": false }, "tags": [ { "name": "Interviews & Evaluations", "description": "Search and retrieve interviews & evaluations data" } ], "paths": { "/hiring/evaluations/search": { "post": { "tags": [ "Interviews & Evaluations" ], "operationId": "post_hiring-evaluations-search", "summary": "Search evaluations", "description": "Searches evaluation records using filters and returns paginated results.\n\n\n\n

Testing notes:

\n\n", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluationSearchRequest" }, "examples": { "basicSearch": { "summary": "Basic search - all evaluations", "description": "Retrieve evaluation records with core fields", "value": { "fields": [ "/evaluation/id", "/evaluation/type", "/evaluation/evaluatorId", "/evaluation/name", "/evaluation/status" ], "filters": [], "limit": 100 } }, "filteredSearch": { "summary": "Filter by application ID", "description": "Search with specific filter criteria", "value": { "fields": [ "/evaluation/id", "/evaluation/type", "/evaluation/evaluatorId", "/evaluation/name", "/evaluation/status", "/evaluation/recommendation", "/evaluation/score", "/evaluation/applicationId", "/evaluation/createdAt" ], "filters": [ { "fieldId": "/evaluation/applicationId", "operator": "equals", "values": [ 7247348 ] } ], "limit": 50 } } } } } }, "responses": { "200": { "description": "Successfully retrieved evaluation records", "headers": { "X-RateLimit-Limit": { "description": "Maximum requests per minute", "schema": { "type": "integer", "example": 120 } }, "X-RateLimit-Remaining": { "description": "Remaining requests in current window", "schema": { "type": "integer", "example": 119 } }, "X-RateLimit-Reset": { "description": "Seconds until rate limit resets", "schema": { "type": "integer", "example": 60 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluationSearchResponse" }, "examples": { "successResponse": { "summary": "Successful response", "value": { "items": [ { "/evaluation/id": 11001, "/evaluation/type": "scorecard", "/evaluation/evaluatorId": 2730269, "/evaluation/name": "Technical Evaluation", "/evaluation/status": "submitted", "/evaluation/recommendation": "yes", "/evaluation/score": 4.5, "/evaluation/applicationId": 7247348, "/evaluation/createdAt": "2024-08-16T14:30:00Z" } ], "response_metadata": { "next_cursor": "eyJpZCI6MTIzNDU2Nzg5fQ==" } } } } } } }, "400": { "description": "Bad Request - Invalid parameters", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "code": "INVALID_ARGUMENT", "message": "Invalid field ID", "requestId": "a1b2c3d4e5f6" } } } }, "401": { "description": "Unauthorized - Invalid or missing credentials", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "403": { "description": "Forbidden - IP not allowed or feature not enabled", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "code": "FORBIDDEN", "message": "Access denied: IP address is not allowed", "requestId": "a1b2c3d4e5f6" } } } }, "429": { "description": "Rate limit exceeded", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "code": "RATE_LIMITED", "message": "Rate limit exceeded. Try again in 45 seconds.", "requestId": "a1b2c3d4e5f6" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "Basic": [] } ], "x-internal": false } } }, "components": { "securitySchemes": { "Basic": { "type": "http", "scheme": "basic", "description": "Basic HTTP authentication using service user credentials" } }, "schemas": { "EvaluationSearchRequest": { "type": "object", "required": [ "fields" ], "default": { "fields": [ "/evaluation/id", "/evaluation/type", "/evaluation/evaluatorId", "/evaluation/name", "/evaluation/status" ], "filters": [], "limit": 100 }, "properties": { "fields": { "type": "array", "items": { "type": "string", "enum": [ "/evaluation/id", "/evaluation/type", "/evaluation/evaluatorType", "/evaluation/evaluatorId", "/evaluation/evaluationScorecardTemplateId", "/evaluation/questionnaireId", "/evaluation/form", "/evaluation/answererId", "/evaluation/name", "/evaluation/stageId", "/evaluation/status", "/evaluation/recommendation", "/evaluation/recommendationComment", "/evaluation/assignedComment", "/evaluation/score", "/evaluation/dueAt", "/evaluation/submittedAt", "/evaluation/createdAt", "/evaluation/applicationId", "/evaluation/lastNotificationSentAt", "/evaluation/notificationJobId", "/evaluation/submittedBy", "/evaluation/createdBy", "/evaluation/skillsSnapshotId" ] }, "description": "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 fields object defined on each item in the 200 response schema." }, "filters": { "type": "array", "items": { "type": "object", "required": [ "fieldId", "operator", "values" ], "properties": { "fieldId": { "type": "string", "enum": [ "/evaluation/id", "/evaluation/applicationId", "/evaluation/status" ], "description": "Field ID to filter by" }, "operator": { "type": "string", "enum": [ "equals", "notEqual", "greaterThan", "lessThan" ], "description": "Filter operator. Use 'equals'/'notEqual' for exact matching. Use 'greaterThan'/'lessThan' for date range filtering.\n" }, "values": { "type": "array", "items": { "type": [ "string", "number" ] } } } }, "default": [] }, "limit": { "type": "integer", "minimum": 1, "maximum": 200, "default": 100 }, "cursor": { "type": "string" }, "includeArchived": { "type": "boolean", "default": false } } }, "EvaluationSearchResponseObject": { "type": "object", "description": "Flat key-value map of field IDs to values. Only requested fields are included.", "properties": { "/evaluation/id": { "type": "integer", "format": "int64", "description": "Unique identifier" }, "/evaluation/type": { "type": "string", "enum": [ "quick", "scorecard", "resume_screening" ], "description": "Evaluation type. Possible values:
" }, "/evaluation/evaluatorType": { "type": "string", "enum": [ "employee" ], "description": "Type of evaluator. Currently only employee is supported." }, "/evaluation/evaluatorId": { "type": "string", "description": "Evaluator employee ID

To read this employee, use Read company employee fields by employee ID ↗." }, "/evaluation/evaluationScorecardTemplateId": { "type": "number", "description": "Evaluation scorecard template ID.

To fetch the template, use Search evaluation scorecard templates ↗." }, "/evaluation/questionnaireId": { "type": "number", "description": "Internal questionnaire ID associated with this evaluation" }, "/evaluation/form": { "type": "object", "description": "Questionnaire form structure with questions and submitted answers. Populated from the questionnaire service when the evaluation has an associated questionnaire.", "properties": { "questionnaire": { "type": "object", "description": "The questionnaire definition", "properties": { "id": { "type": "integer", "description": "Questionnaire ID" }, "title": { "type": "string", "description": "Questionnaire title" }, "showQuestionNumbers": { "type": "boolean", "description": "Whether to show question numbers" }, "items": { "type": "array", "description": "Ordered list of categories, each containing questions.", "items": { "type": "object", "properties": { "id": { "type": "integer", "description": "Category ID" }, "title": { "type": "string", "description": "Category title" }, "order": { "type": "integer", "description": "Display order" }, "isPrivate": { "type": "boolean", "description": "Whether this category is private" }, "items": { "type": "array", "description": "Questions in this category", "items": { "type": "object", "description": "A question item. Structure varies by question type (scale, text, etc.). Common fields include id, title, order, and description." } } } } } } }, "answers": { "type": "array", "description": "Submitted answers for the questionnaire", "items": { "type": "object", "description": "An answer item. Structure depends on question type (e.g. scale answers have answerId referring to a scale value)." } } } }, "/evaluation/answererId": { "type": "string", "description": "Answerer employee ID

To read this employee, use Read company employee fields by employee ID ↗." }, "/evaluation/name": { "type": "string", "description": "Evaluation name" }, "/evaluation/stageId": { "type": "number", "description": "Pipeline stage ID" }, "/evaluation/status": { "type": "string", "enum": [ "new", "in_progress", "scheduled_in_progress", "completed", "canceled", "scheduled" ], "description": "Evaluation status. Possible values:
" }, "/evaluation/recommendation": { "type": "string", "enum": [ "pending", "undetermined", "no", "yes", "strong_yes" ], "description": "Recommendation. Possible values:
" }, "/evaluation/recommendationComment": { "type": "string", "description": "Recommendation comment" }, "/evaluation/assignedComment": { "type": "string", "description": "Comment added when evaluation was assigned" }, "/evaluation/score": { "type": "number", "description": "Evaluation score" }, "/evaluation/dueAt": { "type": "string", "format": "date-time", "description": "Due date" }, "/evaluation/submittedAt": { "type": "string", "format": "date-time", "description": "Submission timestamp" }, "/evaluation/createdAt": { "type": "string", "format": "date-time", "description": "Creation timestamp" }, "/evaluation/applicationId": { "type": "number", "description": "ID of the associated application.

To fetch the application, use Search applications ↗." }, "/evaluation/lastNotificationSentAt": { "type": "string", "format": "date-time", "description": "Last notification sent timestamp" }, "/evaluation/notificationJobId": { "type": "string", "description": "Internal notification job identifier" }, "/evaluation/submittedBy": { "type": "string", "description": "Employee ID of the person who submitted

To read this employee, use Read company employee fields by employee ID ↗." }, "/evaluation/createdBy": { "type": "string", "description": "Employee ID of the person who created

To read this employee, use Read company employee fields by employee ID ↗." }, "/evaluation/skillsSnapshotId": { "type": "number", "description": "ID of the skills snapshot captured at the time of evaluation" } } }, "EvaluationSearchResponse": { "type": "object", "required": [ "items", "response_metadata" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/EvaluationSearchResponseObject" }, "description": "Array of evaluation objects" }, "response_metadata": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ], "description": "Cursor for next page. Null if no more results." } } } } }, "ErrorResponse": { "type": "object", "required": [ "code", "message", "requestId" ], "properties": { "code": { "type": "string", "enum": [ "INVALID_ARGUMENT", "FORBIDDEN", "RATE_LIMITED", "INTERNAL_ERROR", "NOT_FOUND" ], "description": "Error code identifying the type of error:\n- `INVALID_ARGUMENT`: Invalid request parameters\n- `FORBIDDEN`: Access denied (IP not allowed or feature disabled)\n- `RATE_LIMITED`: Too many requests\n- `INTERNAL_ERROR`: Server-side error\n- `NOT_FOUND`: Resource not found\n" }, "message": { "type": "string", "description": "Human-readable error message" }, "requestId": { "type": "string", "description": "Unique request identifier for tracking and debugging" } } } } } } ```