# Analytics

## Retrieve analytics

 - [GET /report](https://docs.converz.co/openapi/analytics/getreport.md): This endpoint retrieves aggregated analytics over conversations and/or in-app user activity as JSON rows.

Use the query parameters to:
- Control the time range (start_date, end_date, or days)
- Filter by dimensions such as vendor, rep_id, campaign, department, and subcampaign
- Choose which metrics to include via the metric parameter

The groupby parameter controls how results are grouped, for example:
- groupby=date → one row per calendar date
- groupby=date,campaign → one row per date per campaign
- groupby=rep_id → one row per user

Time variables week, month, and quarter automatically imply year. The half time variable
groups data into an earlier and later half of the period.