Skip to main content
GET
/
hris
/
performance-reviews
Get performance reviews 🦄
curl --request GET \
  --url https://api.kombo.dev/v1/hris/performance-reviews \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'
{
  "status": "success",
  "data": {
    "id": "B2fqrapywofZryUrmJn6mMKs",
    "remote_id": "e6a20164-4047-447f-830a-d44a5cf8f2d9",
    "type": "MANAGER",
    "reviewee": {
      "id": "26vafvWSRmbhNcxJYqjCzuJg",
      "remote_id": "32",
      "first_name": "John",
      "last_name": "Doe",
      "display_full_name": "John Doe",
      "work_email": "john.doe@acme.com"
    },
    "reviewer": {
      "id": "4EeSSSd9Fr8iiW9mPKmjEVWK",
      "remote_id": "1024",
      "first_name": "Peter",
      "last_name": "Doe",
      "display_full_name": "Peter Doe",
      "work_email": "peter.doe@acme.com"
    },
    "review_cycle": {
      "id": "EiuNHJj2uqCcB7TqbCvEK5wA",
      "remote_id": "32325554-5f85-4125-94a9-39917cf33b50",
      "name": "2023 Performance Review Cycle",
      "start_date": "2023-01-01T00:00:00.000Z",
      "changed_at": "2022-08-07T14:01:29.196Z",
      "remote_deleted_at": null,
      "remote_data": null
    },
    "summary_rating": {
      "type": "SINGLE_SELECT",
      "ordered_options": [
        "Needs improvement",
        "Below expectations",
        "Meets expectations",
        "Exceeds expectations",
        "Exceptional"
      ],
      "value": "Exceeds expectations"
    },
    "summary_comment": "Good job this year! Let's keep it up for 2024!",
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_data": null
  }
}
Beta Feature: This endpoint is currently in beta. Please reach out to our support team if you need assistance with implementation.

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

​
X-Integration-Id
string
required

ID of the integration you want to interact with.

Query Parameters

​
ids
string

Filter by a comma-separated list of IDs such as 222k7eCGyUdgt2JWZDNnkDs3,B5DVmypWENfU6eMe6gYDyJG3.

​
remote_ids
string

Filter by a comma-separated list of remote IDs.

​
types
string

Filter by a comma-separated list of MANAGER, DIRECT_REPORT, PEER, SELF

Leave this blank to get results matching all values.

​
review_cycle_ids
string

Filter by a comma-separated list of review cycle IDs.

​
reviewee_ids
string

Filter by a comma-separated list of reviewee IDs.

Response

GET /hris/performance-reviews Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Examples:
{
  "id": "B2fqrapywofZryUrmJn6mMKs",
  "remote_id": "e6a20164-4047-447f-830a-d44a5cf8f2d9",
  "type": "MANAGER",
  "reviewee": {
    "id": "26vafvWSRmbhNcxJYqjCzuJg",
    "remote_id": "32",
    "first_name": "John",
    "last_name": "Doe",
    "display_full_name": "John Doe",
    "work_email": "john.doe@acme.com"
  },
  "reviewer": {
    "id": "4EeSSSd9Fr8iiW9mPKmjEVWK",
    "remote_id": "1024",
    "first_name": "Peter",
    "last_name": "Doe",
    "display_full_name": "Peter Doe",
    "work_email": "peter.doe@acme.com"
  },
  "review_cycle": {
    "id": "EiuNHJj2uqCcB7TqbCvEK5wA",
    "remote_id": "32325554-5f85-4125-94a9-39917cf33b50",
    "name": "2023 Performance Review Cycle",
    "start_date": "2023-01-01T00:00:00.000Z",
    "changed_at": "2022-08-07T14:01:29.196Z",
    "remote_deleted_at": null,
    "remote_data": null
  },
  "summary_rating": {
    "type": "SINGLE_SELECT",
    "ordered_options": [
      "Needs improvement",
      "Below expectations",
      "Meets expectations",
      "Exceeds expectations",
      "Exceptional"
    ],
    "value": "Exceeds expectations"
  },
  "summary_comment": "Good job this year! Let's keep it up for 2024!",
  "changed_at": "2022-08-07T14:01:29.196Z",
  "remote_deleted_at": null,
  "remote_data": null
}
⌘I