# Matomo CustomReports API

**Canonical:** https://apis.io/apis/matomo/custom-reports-api/  
**Provider:** Matomo — https://apis.io/providers/matomo/  
**Base URL:** https://{matomo_host}/index.php  
**Documentation:** https://developer.matomo.org/api-reference/reporting-api

Matomo CustomReports API is one of 61 APIs that [Matomo](https://apis.io/providers/matomo/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Analytics, Custom Reports, and Reporting. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The Matomo CustomReports API exposes 13 operations of the Matomo Reporting API (module `CustomReports`). Build and read custom report definitions combining arbitrary dimensions and metrics. Every operation is dispatched through the single `/index.php?module=API&method=CustomReports.<Action>` entrypoint on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference plugin.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/openapi/matomo-custom-reports-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/overlays/matomo-custom-reports-overlay.yaml
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api

## Other Matomo APIs (12)

- [Matomo Live API](https://apis.io/apis/matomo/live-api/)
- [Matomo Goals API](https://apis.io/apis/matomo/goals-api/)
- [Matomo Segments API](https://apis.io/apis/matomo/segments-api/)
- [Matomo Reporting API (index.php entrypoint)](https://apis.io/apis/matomo/matomo-index-php-api/)
- [Matomo Tracking API (matomo.php entrypoint)](https://apis.io/apis/matomo/matomo-matomo-php-api/)
- [Matomo SitesManager API](https://apis.io/apis/matomo/sites-manager-api/)
- [Matomo TagManager API](https://apis.io/apis/matomo/tag-manager-api/)
- [Matomo UsersManager API](https://apis.io/apis/matomo/users-manager-api/)
- [Matomo CrashAnalytics API](https://apis.io/apis/matomo/crash-analytics-api/)
- [Matomo HeatmapSessionRecording API](https://apis.io/apis/matomo/heatmap-session-recording-api/)
- [Matomo FormAnalytics API](https://apis.io/apis/matomo/form-analytics-api/)
- [Matomo Referrers API](https://apis.io/apis/matomo/referrers-api/)

## Tags

Analytics, Custom Reports, Reporting

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/matomo/custom-reports-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/matomo/.