> ## 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 Usage Report

> Inspect the detailed email and SMS review request usage funnel.

```
get_usage_report
```

## Description

Returns the complete request-to-review funnel, including per-source click data. Use it when the user needs SMS opens, source-level click details, or a per-location tabular view. For a simpler account summary, use [`get_review_conversion_report`](/mcp/tools/reports/get-review-conversion-report).

## Parameters

| Parameter         | Type           | Required | Default                        | Description                                   |
| ----------------- | -------------- | -------- | ------------------------------ | --------------------------------------------- |
| `startDate`       | string         | No       | —                              | Start date in `MM/DD/YYYY` format             |
| `endDate`         | string         | No       | —                              | End date in `MM/DD/YYYY` format               |
| `days`            | integer        | No       | 30 when no period is requested | Relative window in days                       |
| `months`          | integer        | No       | —                              | Relative window in months                     |
| `reviewSites`     | list\[integer] | No       | All sources                    | Review source IDs to include                  |
| `ratings`         | list\[integer] | No       | All ratings                    | Star ratings from `0` to `5`                  |
| `businessNumbers` | list\[integer] | No       | All locations                  | Location IDs to include                       |
| `reportType`      | string         | No       | Summary view                   | Pass `"Tabular"` for a per-location breakdown |
| `sindex`          | integer        | No       | `0`                            | Pagination start index                        |
| `count`           | integer        | No       | `25`                           | Records to return                             |

## Example Usage

```
Show review request performance location by location for the last 30 days.
```

## Example Response

```json theme={null}
[
  {
    "name": "Total",
    "alias1": "Total",
    "emailSentInfo": { "total": 1200, "percent": 100, "reqCount": 1050, "reqReminderCount": 150 },
    "emailOpenInfo": { "total": 720, "percent": 60.0 },
    "emailClickInfo": {
      "total": 240,
      "percent": 20.0,
      "rcmdCount": [
        { "name": "Google", "count": 155, "percent": 64.6, "sourceId": 2 },
        { "name": "Facebook", "count": 45, "percent": 18.8, "sourceId": 110 }
      ],
      "nonRcmdCount": [
        { "name": "Birdeye", "count": 40, "percent": 16.7, "sourceId": 100 }
      ]
    },
    "rcmdReviewsCount": [
      { "sourceId": 2, "sourceName": "Google", "sourceAlias": "google", "reviewCount": 86 }
    ],
    "nonRcmdReviewsCount": [
      { "sourceId": 100, "sourceName": "Birdeye", "sourceAlias": "birdeye", "reviewCount": 24 }
    ],
    "smsSentInfo": { "total": 800, "percent": 100, "reqCount": 800 },
    "smsOpenInfo": { "total": 260, "percent": 32.5 },
    "smsClickInfo": {
      "total": 200,
      "percent": 25.0,
      "rcmdCount": [
        { "name": "Google", "count": 135, "percent": 67.5, "sourceId": 2 }
      ]
    },
    "totalReviewsCount": 110
  }
]
```

## Response Fields

Each row includes email and SMS sent, open, and click information; recommended and non-recommended source click counts; reviews generated by source; and `totalReviewsCount`. Summary mode returns a `Total` row, while tabular mode returns location rows.

## Notes

* All click percentages are based on the sent total for that channel, not the open total. `emailSentInfo.percent`/`smsSentInfo.percent` are self-referential and equal `100` — confirmed in testing.
* With no `reportType`, the response is a single-element array containing the `"Total"` account rollup, matching the schema's "graph view." Pass `reportType: "Tabular"` for one row per location.