Performance > ReviewEvaluation

Reads all Review evaluations

Changed on

Retrieves the pending and published review evaluations. The evaluations are created based on the participants and the review types when the review process is started.

For example, if the defined review types are "self-review" and "manager review," two evaluations will be created for each participant when the review process starts. One will be for the self-review, where the participant is both the target and the reviewer. The other will be for the manager review, where the participant is the target, and the manager is the reviewer.

get/api/2026-10-01/resources/performance/review_evaluations

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/performance/review_evaluations
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: performance
    • or API key in header x-api-key

Query parameters

ids[]string[]

Filter by evaluation IDs

[
  "1",
  "2",
  "3"
]
performance_review_process_ids[]string[]

Filter by review process IDs

[
  "1",
  "2",
  "3"
]
publishedboolean

Only published or unpublished evaluations

Example:true
reviewer_ids[]string[]

Filter by reviewer access IDs

[
  "1",
  "2",
  "3"
]
reviewer_strategies[]string[]

Filter by reviewer strategies

[
  "manager",
  "peer"
]
target_access_ids[]string[]

Filter by participant access IDs

[
  "1",
  "2",
  "3"
]
review_process_target_ids[]string[]

Filter by review process target IDs. Composite key format: review_process_id-target_access_id

[
  "1-1",
  "1-2",
  "1-3"
]
manager_employee_idstring required
only_direct_reportsboolean required
{
  "manager_employee_id": 1,
  "only_direct_reports": false
}
exclude_ids[]string[]

Exclude evaluations by IDs

[
  "1",
  "2",
  "3"
]

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "performance_review_process_id": "1",
      "target_access_id": "1",
      "reviewer_access_id": "1",
      "evaluation_type": "manager",
      "published": true,
      "status": "published",
      "published_at": "2024-01-01T00:00:00Z"
    }
  ]
}

Changes