Get usage
Get usage data for the given time range.
If no time range is provided, returns usage for the past 7 days (including today).
Usage is aggregated hourly — see Data freshness before scheduling reporting jobs.
Authorizations
Query Parameters
Start date to query usage (UTC).
Maximum 31 days from current date.
Must be earlier than the to date/time.
End date/time to query usage (UTC).
Accepted formats: date (2025-01-01) or RFC3339 (2025-01-01T10:00:00Z).
Must be later than the from date/time.
Usage is aggregated in hourly buckets, and the range includes the hourly bucket containing to. A date-only value is interpreted as midnight UTC (00:00:00), so it returns only the first hour of that day — to include a full final day, pass to=YYYY-MM-DDT23:59:59Z.
Response
Successfully retrieved usage
Date for usage data
"2025-01-01"
Total number of connections
1000
The number of successful connections
500
Bytes consumed (raw bytes).
To convert to GB as shown in the dashboard, divide by 10⁹ (decimal GB, not 2³⁰).
123456789