{"type":"api","title":"Get Bandwidth Distribution","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-26-1-api-guide/860ec01932f5fb639b929c353dd9d967dc0b4347/d2f02ba2-fd0d-3a26-bcc5-feafc8f24d17","info":{"title":"Monitoring and Troubleshooting","description":"Includes API operations for the following:\n Real-time monitoring\n Accessing statistics APIs and statistics bulk APIs\n Retrieving device state\n Managing alarms and events","contact":{"email":"vmanage@cisco.com"},"license":{"name":"Commercial License","url":"https://www.cisco.com/c/en/us/solutions/enterprise-networks/sd-wan/index.html"},"version":"26.1.0+2026-01-06"},"x-parser-conf":{"overview":{"markdownPath":"openapi/overview_part2.md"}},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Monitoring - Interface Statistics"],"description":"Get bandwidth distribution","operationId":"getBandwidthDistribution","parameters":[{"name":"site-id","in":"query","schema":{"pattern":"^[0-9]+$","type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"avg_down_capacity_percentage":{"type":"number"},"avg_up_capacity_percentage":{"type":"number"},"bw_down":{"type":"integer","format":"int64"},"bw_up":{"type":"number"},"count":{"type":"integer","format":"int64"},"interface":{"type":"string"},"max_down_capacity_percentage":{"type":"number"},"max_up_capacity_percentage":{"type":"number"},"min_down_capacity_percentage":{"type":"number"},"min_up_capacity_percentage":{"type":"integer","format":"int32"},"range":{"type":"string"},"vdevice_name":{"type":"string"}},"$$ref":"#/components/schemas/CapacityRespData"}},"distribution":{"type":"object","properties":{"100":{"type":"integer","format":"int64"},"0-25":{"type":"integer","format":"int64"},"25-50":{"type":"integer","format":"int64"},"50-75":{"type":"integer","format":"int64"},"75-100":{"type":"integer","format":"int64"},"uncategorized":{"type":"integer","format":"int64"}},"$$ref":"#/components/schemas/CapDistribution"}},"$$ref":"#/components/schemas/CapacityResp"},"examples":{"Bandwidth Distribution":{"description":"Bandwidth Distribution","value":{"query":{"condition":"AND","rules":[{"value":["24"],"field":"entry_time","type":"date","operator":"last_n_hours"},{"value":["1.1.60.7"],"field":"vdevice_name","type":"string","operator":"in"}]},"aggregation":{"field":[{"property":"family","size":200,"sequence":1}],"metrics":[{"property":"octets","type":"sum","order":"desc"}]}}}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"method":"get","path":"/statistics/interface/ccapacity/distribution"}}