Get cost breakdown
Authorization
BearerAuth In: header
Query Parameters
Response format: table (paginated UI), chart (aggregated stacked bar), csv (export), raw (all records)
Period in YYYY-MM format (defaults to current month)
Filter by provider: aws, gcp, azure, k8s
Granularity: 'daily' or 'monthly' (used for chart format)
Grouping dimension for chart format: 'provider' (default) or 'account_id'
Start date in ISO 8601 format (e.g., 2026-02-01T00:00:00.000Z). Used for chart and table formats
End date in ISO 8601 format (e.g., 2026-02-01T00:00:00.000Z). Used for chart and table formats
Page number (1-indexed, table format only)
Items per page (max 100, table format only)
Sort field: cost, service, region, account_id, change_percentage
Sort order
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/costs/breakdown"{
"success": true,
"timestamp": "2019-08-24T14:15:22Z",
"data": {
"period": "string",
"items": [
{
"service": "string",
"provider_id": "string",
"environment": "string",
"region": "string",
"account_id": "string",
"tag_key": "string",
"tag_value": "string",
"cost": 0,
"previous_cost": 0,
"change_percentage": 0
}
],
"pagination": {
"total_items": 0,
"total_pages": 0,
"current_page": 0,
"page_size": 0,
"has_next": true,
"has_previous": true
}
}
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"details": null
},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"details": null
},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"details": null
},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"details": null
},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"details": null
},
"timestamp": "2019-08-24T14:15:22Z"
}{
"property1": null,
"property2": null
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"details": null
},
"timestamp": "2019-08-24T14:15:22Z"
}{
"success": false,
"error": {
"code": "string",
"message": "string",
"details": null
},
"timestamp": "2019-08-24T14:15:22Z"
}