> ## Documentation Index
> Fetch the complete documentation index at: https://birdeye-0229a3ce-responsetools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Review Count By Rating By Employee

> Compare review rating distributions for assisted employees.

```
get_review_count_by_rating_by_employee
```

## Description

Returns the review count by rating for each assisted employee. Use it for employee-level review volume and rating analysis.

## Parameters

| Parameter         | Type           | Required | Default                | Description                                                                 |
| ----------------- | -------------- | -------- | ---------------------- | --------------------------------------------------------------------------- |
| `fromDate`        | string         | No       | —                      | Start date in `MM/DD/YYYY` format                                           |
| `toDate`          | string         | No       | —                      | End date in `MM/DD/YYYY` format                                             |
| `sourceAlias`     | list\[string]  | No       | All sources            | Review sources to include                                                   |
| `businessNumbers` | list\[integer] | No       | All locations          | Location IDs to include                                                     |
| `employees`       | list\[object]  | No       | All assisted employees | Employee filters containing `firstName`, `lastName`, and optionally `phone` |

## Example Usage

```
Compare the review rating distribution by staff member for last quarter.
```

## Example Response

```json theme={null}
{
  "employees": [
    {
      "employee": { "firstName": "David", "lastName": "Wood" },
      "countByRating": [
        { "rating": 0, "count": 0 },
        { "rating": 1, "count": 1 },
        { "rating": 2, "count": 0 },
        { "rating": 3, "count": 2 },
        { "rating": 4, "count": 8 },
        { "rating": 5, "count": 24 }
      ]
    },
    {
      "employee": { "firstName": "Maya", "lastName": "Patel" },
      "countByRating": [
        { "rating": 0, "count": 1 },
        { "rating": 1, "count": 0 },
        { "rating": 2, "count": 1 },
        { "rating": 3, "count": 1 },
        { "rating": 4, "count": 6 },
        { "rating": 5, "count": 27 }
      ]
    }
  ]
}
```

## Response Fields

Each `employees` entry contains an `employee` object with the staff member name and `countByRating` entries with `rating` and `count`.

## Notes

* Employee phone numbers are removed from responses. Refer to employees by name only.
* Only provide a phone number as an input when the user explicitly supplied it to distinguish employees with the same name.
* Rating `0` represents Facebook recommendations without a star value, not zero-star reviews.
* `employee` can be `null` (reviews with no identifiable assisted staff member), and even when present, `employee.lastName` can independently be `null` while `firstName` is set. Handle both fields defensively rather than assuming they're always populated.
* The `employees` array is not sorted by review count or rating in testing — sort client-side if a "top employee" view is needed.
