{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/GetHrisPerformanceReviewsPositiveResponse",
"title": "GetHrisPerformanceReviewsPositiveResponse",
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "success"
},
"data": {
"type": "object",
"properties": {
"next": {
"type": [
"string",
"null"
],
"description": "Cursor string that can be passed to the `cursor` query parameter to get the next page. If this is `null`, then there are no more pages."
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing."
},
"remote_id": {
"type": "string",
"description": "The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key."
},
"type": {
"type": [
"string",
"null"
],
"enum": [
"MANAGER",
"DIRECT_REPORT",
"PEER",
"SELF"
],
"description": "The relationship between the reviewee and reviewer. Manager: The reviewer is the manager of the reviewee. Direct Report: The reviewer is a direct report of the reviewee (reverse MANAGER). Peer: The reviewer is a peer of the reviewee. Self: The reviewer is the reviewee himself/herself. null: The relationship cannot be determined or the reviewer is missing."
},
"summary_comment": {
"type": [
"string",
"null"
],
"description": "The summary comment of the performance review."
},
"summary_rating": {
"discriminator": {
"propertyName": "type"
},
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "NUMERIC"
},
"min": {
"type": [
"number",
"null"
],
"format": "double",
"minimum": -1.7976931348623157e+308,
"description": "The minimum value of the summary rating."
},
"max": {
"type": [
"number",
"null"
],
"format": "double",
"minimum": -1.7976931348623157e+308,
"description": "The maximum value of the summary rating."
},
"value": {
"type": [
"number",
"null"
],
"format": "double",
"minimum": -1.7976931348623157e+308,
"description": "The numeric value of the summary rating."
}
},
"required": [
"type",
"min",
"max",
"value"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "SINGLE_SELECT"
},
"ordered_options": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "The options of the summary rating. Ordered from bad to good."
},
"value": {
"type": [
"string",
"null"
],
"description": "The text value of the summary rating."
}
},
"required": [
"type",
"ordered_options",
"value"
]
},
{
"type": "null"
}
],
"description": "The summary rating of the performance review."
},
"changed_at": {
"description": "The timestamp when this specific record was last modified. This field only updates when properties directly on this record change, NOT when related or nested models change. For filtering that considers nested data changes, use the `updated_after` parameter which will return records when either the record itself OR its related models have been updated.",
"type": "string",
"format": "date-time",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString"
}
},
"remote_deleted_at": {
"description": "The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.",
"type": [
"string",
"null"
],
"format": "date-time",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString"
}
},
"remote_data": {
"type": [
"object",
"null"
],
"additionalProperties": true,
"description": "Includes the data fetched from the remote system.\nPlease be aware that including this in you scope config might violate other\nscopes that are set.\n\nRemote data always has the endpoint path that we got the data from as the\ntop level key. For example, it could look like: `{ \"/companies\": { ... }}`\n\nThis is not available on all plans. Reach out to Kombo if you need it."
},
"reviewee": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing."
},
"remote_id": {
"type": "string",
"description": "The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key."
},
"first_name": {
"type": [
"string",
"null"
],
"description": "The employee\u2019s first name."
},
"last_name": {
"type": [
"string",
"null"
],
"description": "The employee\u2019s last name."
},
"display_full_name": {
"type": [
"string",
"null"
],
"description": "The employee\u2019s full name, including any middle names. Not all HR systems provide an explicit display name, so we recommend falling back to `first_name` and `last_name`."
},
"work_email": {
"type": [
"string",
"null"
],
"pattern": "^(?!\\.)(?!.*\\.\\.)([\\w'+-.]*)[\\w+-]@([\\da-z][\\da-z-]*\\.)+[a-z]{2,}$",
"description": "The employee\u2019s work email address. If the email address is invalid, we will set this to `null`."
},
"remote_deleted_at": {
"description": "The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.",
"type": [
"string",
"null"
],
"format": "date-time",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString"
}
}
},
"required": [
"id",
"remote_id",
"first_name",
"last_name",
"display_full_name",
"remote_deleted_at"
],
"description": "The employee receiving the review.",
"examples": [
{
"id": "26vafvWSRmbhNcxJYqjCzuJg",
"remote_id": "32",
"first_name": "John",
"last_name": "Doe",
"display_full_name": "John Doe",
"work_email": "[email protected]",
"remote_deleted_at": null
},
{
"id": "26vafvWSRmbhNcxJYqjCzuJg",
"remote_id": "32",
"first_name": "John",
"last_name": "Doe",
"display_full_name": "John Doe",
"work_email": "[email protected]",
"remote_deleted_at": null
}
]
},
"reviewer": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string",
"description": "The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing."
},
"remote_id": {
"type": "string",
"description": "The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key."
},
"first_name": {
"type": [
"string",
"null"
],
"description": "The employee\u2019s first name."
},
"last_name": {
"type": [
"string",
"null"
],
"description": "The employee\u2019s last name."
},
"display_full_name": {
"type": [
"string",
"null"
],
"description": "The employee\u2019s full name, including any middle names. Not all HR systems provide an explicit display name, so we recommend falling back to `first_name` and `last_name`."
},
"work_email": {
"type": [
"string",
"null"
],
"pattern": "^(?!\\.)(?!.*\\.\\.)([\\w'+-.]*)[\\w+-]@([\\da-z][\\da-z-]*\\.)+[a-z]{2,}$",
"description": "The employee\u2019s work email address. If the email address is invalid, we will set this to `null`."
},
"remote_deleted_at": {
"description": "The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.",
"type": [
"string",
"null"
],
"format": "date-time",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString"
}
}
},
"required": [
"id",
"remote_id",
"first_name",
"last_name",
"display_full_name",
"remote_deleted_at"
],
"description": "The employee giving/writing the review.",
"examples": [
{
"id": "4EeSSSd9Fr8iiW9mPKmjEVWK",
"remote_id": "1024",
"first_name": "Peter",
"last_name": "Doe",
"display_full_name": "Peter Doe",
"work_email": "[email protected]",
"remote_deleted_at": null
}
]
},
"review_cycle": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": "string",
"description": "The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing."
},
"remote_id": {
"type": "string",
"description": "The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key."
},
"name": {
"type": [
"string",
"null"
],
"description": "The name of the performance review cycle."
},
"review_period_start_date": {
"description": "The start date of the review period of the performance review cycle. It is the start date of the evaluation timeframe and the earliest date reviews can be submitted for this cycle.",
"type": [
"string",
"null"
],
"format": "date-time",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString"
}
},
"changed_at": {
"description": "The timestamp when this specific record was last modified. This field only updates when properties directly on this record change, NOT when related or nested models change. For filtering that considers nested data changes, use the `updated_after` parameter which will return records when either the record itself OR its related models have been updated.",
"type": "string",
"format": "date-time",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString"
}
},
"remote_deleted_at": {
"description": "The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.",
"type": [
"string",
"null"
],
"format": "date-time",
"externalDocs": {
"url": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString"
}
},
"remote_data": {
"type": [
"object",
"null"
],
"additionalProperties": true,
"description": "Includes the data fetched from the remote system.\nPlease be aware that including this in you scope config might violate other\nscopes that are set.\n\nRemote data always has the endpoint path that we got the data from as the\ntop level key. For example, it could look like: `{ \"/companies\": { ... }}`\n\nThis is not available on all plans. Reach out to Kombo if you need it."
}
},
"required": [
"id",
"remote_id",
"name",
"review_period_start_date",
"changed_at",
"remote_deleted_at",
"remote_data"
],
"examples": [
{
"id": "4B9bKBpX5tnwjiG93TAqF7ci",
"remote_id": "1",
"name": "2025 Annual Performance Review Cycle",
"review_period_start_date": "2025-01-01T00:00:00.000Z",
"changed_at": "2022-08-07T14:01:29.196Z",
"remote_deleted_at": null,
"remote_data": null
}
]
}
},
"required": [
"id",
"remote_id",
"type",
"summary_comment",
"changed_at",
"remote_deleted_at",
"remote_data",
"reviewee",
"reviewer",
"review_cycle"
]
}
}
},
"required": [
"next",
"results"
],
"examples": [
{
"next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
"results": [
{
"id": "4B9bKBpX5tnwjiG93TAqF7ci",
"remote_id": "1",
"type": "MANAGER",
"summary_comment": "Good job this year! Let's keep it up for 2024!",
"summary_rating": {
"ordered_options": [
"Needs improvement",
"Below expectations",
"Meets expectations",
"Exceeds expectations",
"Exceptional"
],
"type": "SINGLE_SELECT",
"value": "Exceeds expectations"
},
"changed_at": "2022-08-07T14:01:29.196Z",
"remote_deleted_at": null,
"remote_data": null,
"reviewee": {
"id": "26vafvWSRmbhNcxJYqjCzuJg",
"remote_id": "32",
"first_name": "John",
"last_name": "Doe",
"display_full_name": "John Doe",
"work_email": "[email protected]",
"remote_deleted_at": null
},
"reviewer": {
"id": "4EeSSSd9Fr8iiW9mPKmjEVWK",
"remote_id": "1024",
"first_name": "Peter",
"last_name": "Doe",
"display_full_name": "Peter Doe",
"work_email": "[email protected]",
"remote_deleted_at": null
},
"review_cycle": {
"id": "4B9bKBpX5tnwjiG93TAqF7ci",
"remote_id": "1",
"name": "2025 Annual Performance Review Cycle",
"review_period_start_date": "2025-01-01T00:00:00.000Z",
"changed_at": "2022-08-07T14:01:29.196Z",
"remote_deleted_at": null,
"remote_data": null
}
}
]
}
]
}
},
"required": [
"status",
"data"
]
}