# Matomo Custom Reports API

**Canonical:** https://apis.io/apis/matomo/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 Custom Reports 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 Custom Reports. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Exposes Custom Reports configuration and reporting endpoints. Use it to create, duplicate, manage, and query custom report definitions and their archived data.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/index.php?module=API&method=CustomReports.duplicateCustomReport` | Custom reports duplicate custom report |
| GET | `/index.php?module=API&method=CustomReports.addCustomReport` | Custom reports add custom report |
| GET | `/index.php?module=API&method=CustomReports.updateCustomReport` | Custom reports update custom report |
| GET | `/index.php?module=API&method=CustomReports.getConfiguredReports` | Custom reports get configured reports |
| GET | `/index.php?module=API&method=CustomReports.getConfiguredReport` | Custom reports get configured report |
| GET | `/index.php?module=API&method=CustomReports.deleteCustomReport` | Custom reports delete custom report |
| GET | `/index.php?module=API&method=CustomReports.pauseCustomReport` | Custom reports pause custom report |
| GET | `/index.php?module=API&method=CustomReports.resumeCustomReport` | Custom reports resume custom report |
| GET | `/index.php?module=API&method=CustomReports.getAvailableCategories` | Custom reports get available categories |
| GET | `/index.php?module=API&method=CustomReports.getAvailableReportTypes` | Custom reports get available report types |
| GET | `/index.php?module=API&method=CustomReports.getAvailableDimensions` | Custom reports get available dimensions |
| GET | `/index.php?module=API&method=CustomReports.getAvailableMetrics` | Custom reports get available metrics |
| GET | `/index.php?module=API&method=CustomReports.getCustomReport` | Custom reports get custom report |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/openapi/matomo-custom-reports-api-openapi.yml
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api#Live
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api#Goals
- **Documentation** — https://developer.matomo.org/api-reference/reporting-api-segmentation

## Other Matomo APIs (12)

- [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 Actions API](https://apis.io/apis/matomo/matomo-actions-api/)
- [Matomo Advertising Conversion Export API](https://apis.io/apis/matomo/matomo-advertisingconversionexport-api/)
- [Matomo Annotations API](https://apis.io/apis/matomo/matomo-annotations-api/)
- [Matomo API](https://apis.io/apis/matomo/matomo-api-api/)
- [Matomo Bandwidth API](https://apis.io/apis/matomo/matomo-bandwidth-api/)
- [Matomo Cohorts API](https://apis.io/apis/matomo/matomo-cohorts-api/)
- [Matomo Contents API](https://apis.io/apis/matomo/matomo-contents-api/)
- [Matomo Core Admin Home API](https://apis.io/apis/matomo/matomo-coreadminhome-api/)
- [Matomo Crash Analytics API](https://apis.io/apis/matomo/matomo-crashanalytics-api/)
- [Matomo Custom Alerts API](https://apis.io/apis/matomo/matomo-customalerts-api/)

## Tags

Custom Reports

---

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