# Cisco Umbrella Reporting API

**Canonical:** https://apis.io/apis/cisco-umbrella/reports-reporting/  
**Provider:** Cisco Umbrella — https://apis.io/providers/cisco-umbrella/  
**Base URL:** https://api.umbrella.com/reports/v2  
**Documentation:** https://developer.cisco.com/docs/cloud-security/umbrella-api-reference-reporting-overview/

Cisco Umbrella Reporting API is one of 26 APIs that [Cisco Umbrella](https://apis.io/providers/cisco-umbrella/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Activity, Bandwidth by Hour, Bandwidth by Timerange, Deployment Status, and Identity Distribution. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Reporting API provides the data to generate the Umbrella reports.

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cisco-umbrella/refs/heads/main/openapi/cisco-umbrella-reports-reporting-openapi.yml
- **OpenAPI Source** — https://pubhub.devnetcloud.com/media/cloud-security-apis-in-eft/docs/reference/reports/reporting.yaml
- **Documentation** — https://developer.cisco.com/docs/cloud-security/umbrella-api-reference-reporting-overview/
- **APIReference** — https://developer.cisco.com/docs/cloud-security/umbrella-api-reference-reporting-overview/
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/cisco-umbrella/refs/heads/main/overlays/cisco-umbrella-reports-reporting-overlay.yaml

## Other Cisco Umbrella APIs (12)

- [Cisco Umbrella Key Admin API](https://apis.io/apis/cisco-umbrella/admin-key-admin/)
- [Cicso Umbrella Managed Providers API](https://apis.io/apis/cisco-umbrella/admin-managed-providers/)
- [Cisco Umbrella Providers API](https://apis.io/apis/cisco-umbrella/admin-providers/)
- [Cisco Umbrella S3 Bucket Key Rotation API](https://apis.io/apis/cisco-umbrella/admin-s3-key-rotation/)
- [Cisco Umbrella Service Providers Console API](https://apis.io/apis/cisco-umbrella/admin-service-providers-console/)
- [Cisco Umbrella Users and Roles API](https://apis.io/apis/cisco-umbrella/admin-users-roles/)
- [Cisco Umbrella Token Authorization API](https://apis.io/apis/cisco-umbrella/auth-token/)
- [Cisco Cloudlock API](https://apis.io/apis/cisco-umbrella/cloudlock-cloudlock/)
- [Cisco Umbrella Internal Domains API](https://apis.io/apis/cisco-umbrella/deployments-internal-domains/)
- [Cisco Umbrella Internal Networks API](https://apis.io/apis/cisco-umbrella/deployments-internal-networks/)
- [Cisco Umbrella Network Devices API](https://apis.io/apis/cisco-umbrella/deployments-network-devices/)
- [Cisco Umbrella Network Tunnels API](https://apis.io/apis/cisco-umbrella/deployments-network-tunnels/)

## Tags

Activity, Bandwidth by Hour, Bandwidth by Timerange, Deployment Status, Identity Distribution, Organization Requests by Hour, Organization Requests by Hour and Category, Organization Requests by Timerange, Organization Requests by Timerange and Category, Provider Category Requests by Organization, Provider Deployment Status, Provider Requests by Category, Provider Requests by Destination, Provider Requests by Hour, Provider Requests by Organization, Provider Requests by Timerange, Summaries by Category, Summaries by Destination, Summaries by Rule (Intrusion), Summary, Top Categories, Top DNS Query Types, Top Destinations, Top Event Types, Top Files, Top IPs, Top Identities, Top Threat Types, Top Threats, Total Requests, Umbrella, Utility

---

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