Get Usage Details
Select
Retrieves the usage details for the provided OfferingId as a downloadable CSV file.
- Standard Offering: Provides a monthly usage report in CSV format.
- Hourly Offering (e.g., Cloud Rewind): Provides a CSV report with hourly usage details aggregated for the selected month.
Additional optional query parameters are available to filter results by usage type and usage month.
Query Parameters
- offeringId int32 required
ID of the offering
- usageType string
Possible values: [
peak
,current
]Default value:
peak
Usage type for the report. Note: This parameter is not applicable for Hourly Offering (eg., Cloud Rewind)
- usageMonth date
Default value:
First day of current month
Format: First day of the month in
YYYY-MM-DD
(e.g.2025-06-01
).
- 200
- 400
OK
Response Headers
Content-Disposition string
Indicates the file is intended to be downloaded by clients with this filename. Filename pattern: - Standard:
Subscription Usage Month-to-Date_{Offering Name}_{Usage Month}.csv
- Hourly (Cloud Rewind):Subscription Usage_Cloud Rewind_{Usage Month Start}_to_{Usage Month End / Current Date}.csv
- application/octet-stream
- Schema
- Get Usage Details - Success
- Hourly Offering Usage Details
Schema
- string binary
Email address,Exchange,OneDrive
"abc@xyz.io","1","0"
"bcd@xyz.io","1","1"
"cde@xyz.io","1","1"
"def@xyz.io","0","1"
Start Time,End Time,Cloud,Resource Type,Billable Quantity,Tenant ID
"2025-05-01T00:00:00","2025-05-01T01:00:00","AZURE","PUBLIC_IP_ADDRESS",17,"D8B55198-E20C-48A2-A87C-FD06A3C08063"
"2025-05-01T00:00:00","2025-05-01T01:00:00","AZURE","VIRTUAL_MACHINE",25,"D8B55198-E20C-48A2-A87C-FD06A3C08063"
"2025-05-01T01:00:00","2025-05-01T02:00:00","GCP","VPC_NETWORK ",7,"D8B55198-E20C-48A2-A87C-FD06A3C08063"
"2025-05-01T01:00:00","2025-05-01T02:00:00","GCP","INSTANCE ",11,"D8B55198-E20C-48A2-A87C-FD06A3C08063"
Bad Request - Invalid or missing query parameters
- application/json
- Schema
- Example (from schema)
- Invalid Offering
- Invalid Usage Month
- Invalid Usage Type
Schema
error object
code integermessage string
{
"error": {
"code": 0,
"message": "string"
}
}
{
"error": {
"code": 3166,
"message": "Invalid or missing offering."
}
}
{
"error": {
"code": 3172,
"message": "Invalid usage month."
}
}
{
"error": {
"code": 3174,
"message": "Invalid or missing usageType."
}
}