---
title: "Get aggregated cost summary"
method: GET
path: "/volumes/cost-summary"
tags: ["General APIs with JWT"]
---

# Get aggregated cost summary

`GET /volumes/cost-summary`

Get a comprehensive cost summary for user's volumes including:
    - Total costs by type (storage, egress, requests, other)
    - Top 5 most expensive volumes
    - Summary statistics for the period
    
    **Query Parameters:**
    - `start_date` (required): Start date in YYYY-MM-DD format
    - `end_date` (required): End date in YYYY-MM-DD format (max 3 months from start)

## Query parameters

- `start_date` string, required — Start date in YYYY-MM-DD format
- `end_date` string, required — End date in YYYY-MM-DD format

## Response `200`

Cost summary retrieved successfully

- VolumeCostSummaryResponse — Response model for volume cost summary
  - `user_id` string, uuid, required
  - `total_volumes` integer, required
  - `date_range` object, required
  - `cost_breakdown` object, required
  - `top_volumes` object[], required — Top 5 most expensive volumes

## Other responses

- `400` — Invalid query parameters
- `403` — Volume features not enabled for this user
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/lium/apis/lium-backend-api.md) · [All operations](https://skmtc.dev/lium/apis/lium-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lium/lium-backend-api/revisions/57db0a9348db/schema)