--- title: "Get Performance Reviews" method: GET path: "/api/hris/v1/performance-reviews" tags: ["Performance Reviews"] --- # Get Performance Reviews `GET /api/hris/v1/performance-reviews` ## Request - Base URL: `https://api.bindbee.dev` (the document declares no server; this is the origin it was published from) - URL: `https://api.bindbee.dev/api/hris/v1/performance-reviews` - Auth: HTTP bearer and API key in header `X-Connector-Token` Returns a list of Performance Review objects. ## Query parameters - `ids` string, nullable: The ID of the performance reviews to fetch - `employee_id` string, nullable: The ID of the employees to fetch performance reviews for - `reviewer_id` string, nullable: The ID of the reviewers to fetch performance reviews for - `type` string, nullable: The type of performance review to filter by. Pass several values, comma-separated, to match any of them. - `status` string, nullable: The status of performance review to filter by. Pass several values, comma-separated, to match any of them. - `remote_id` string, nullable: The third-party API ID of the matching object. - `include_raw_data` boolean: Whether to include the original data Bindbee fetched from the third-party to produce these models. - `include_custom_fields` boolean: Whether to include custom fields in the response. - `modified_after` string, nullable: If provided, only objects synced by Bindbee after this date time will be returned. Format: DateTime (ISO 8601). If no timezone offset is supplied, the value is interpreted as UTC. - `review_cycle_start_date_from` string, nullable: If provided, only objects with review_cycle_start_date same or after this date time will be returned. Format: DateTime (ISO 8601). If no timezone offset is supplied, the value is interpreted as UTC. - `review_cycle_start_date_to` string, nullable: If provided, only objects with review_cycle_start_date same or before this date time will be returned. Format: DateTime (ISO 8601). If no timezone offset is supplied, the value is interpreted as UTC. - `review_cycle_end_date_from` string, nullable: If provided, only objects with review_cycle_end_date same or after this date time will be returned. Format: DateTime (ISO 8601). If no timezone offset is supplied, the value is interpreted as UTC. - `review_cycle_end_date_to` string, nullable: If provided, only objects with review_cycle_end_date same or before this date time will be returned. Format: DateTime (ISO 8601). If no timezone offset is supplied, the value is interpreted as UTC. - `page_size` integer: Number of results to return per page. Maximum size is 200. - `cursor` string, nullable: The pagination cursor value. - `expand` string, nullable: Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces. You can also specify required fields in [] for each relation name. Add `.custom_fields` to return an expanded record's custom fields, or `.custom_fields[name,other_name]` for only those (quote a name holding anything but letters, digits, `_` and `-`: `.custom_fields["wd:Visa_ID"]`). ## Response `200` Successful Response - PaginatedResponseHrisPerformanceReview - `cursor` string, nullable, required: Cursor value to fetch next set of items - `page_size` integer, required: The page size the request was served with (0 on an empty page). `items` can be shorter on the last page; `cursor` says whether another page exists. - `items` HrisPerformanceReview[], required: List of items in the current response - `id` string, uuid, required - `remote_id` string, nullable, required: The third-party API ID of the matching object. - `modified_at` string, date-time, required: This is the datetime that this object was last updated by Bindbee - `raw_data` object, nullable: This is the Raw data - `custom_fields` object, nullable, required: The custom fields related to the model - `employee` string, nullable, required: The employee this performance review is for. - `reviewer` string, nullable, required: The employee who conducted this performance review. Null when type is EXTERNAL or unset. - `type` string, nullable, required: The type of performance review. If the value is not one of the defined enum values, the original value passed through will be returned. - `review_cycle_name` string, nullable, required: The name of the review cycle this performance review belongs to. - `review_cycle_start_date` string, nullable, required: The day and time the review cycle started. - `review_cycle_end_date` string, nullable, required: The day and time the review cycle ended. - `comment` string, nullable, required: A free-text comment left on the performance review. - `status` string, nullable, required: The status of the performance review. If the value is not one of the defined enum values, the original value passed through will be returned. - `rating` object, nullable, required: The overall rating given on this performance review, combining both the scale definition and the answer. Shape depends on the embedded 'type' key: when 'type' is 'NUMERIC', the object also carries 'min', 'max', 'step', and 'value'; when 'type' is 'SINGLE_SELECT', the object carries 'options' (the allowed labels) and 'value' (the selected label). ## Other responses - `401`: Missing or invalid bearer authentication credentials. - `403`: The credentials are valid but do not permit access to this resource, e.g. a connector token used on a different API category or a model whose writes are disabled. - `422`: Validation Error - `429`: Rate limit exceeded. ## Changes - **2026-10-06** `1f9bc0ad4bfb`: 9 info - the endpoint scheme security `HTTPBearer AND ConnectorToken` was added to the API - the endpoint scheme security `ConnectorToken` was removed from the API - the endpoint scheme security `HTTPBearer` was removed from the API - removed the `COMPLETED` enum value from the `items/items/status` response property for the response status `200` - …5 more - **2026-09-30** `4695175eeff0`: 1 info - endpoint added [Operation history](https://skmtc.dev/bindbee/apis/bindbee-apis/changes/api/hris/v1/performance-reviews/get.md) --- [API](https://skmtc.dev/bindbee/apis/bindbee-apis.md) - [All operations](https://skmtc.dev/bindbee/apis/bindbee-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/bindbee/apis/bindbee-apis/revisions/572789b789f4?raw)