# Get daily spending breakdown

> Returns daily spending aggregated per day for the given date range

Source: https://docs.levelfour.ai/api-reference/costs/get-costs-daily-breakdown


## GET /api/v1/costs/daily/breakdown

Returns daily spending aggregated per day for the given date range

### Authentication

Send `Authorization: Bearer <token>`.

### Parameters

- `start` (query, string, nullable): Start date in ISO 8601 format (e.g., 2026-02-01T00:00:00.000Z)
- `end` (query, string, nullable): End date in ISO 8601 format (e.g., 2026-02-28T00:00:00.000Z)
- `providerId` (query, string, nullable): Limit the series to one provider
- `credits` (query, one of `before`, `after`, default `after`): Cost basis for Google Cloud: after credits (default) or before them. AWS stays on its invoiced basis.

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (date-time string)
- `data` (object, required): Daily spending breakdown data
  - `start_date` (string, required): Start date in YYYY-MM-DD format
  - `end_date` (string, required): End date in YYYY-MM-DD format
  - `data_points` (array of object, required): Daily spending data points
    - `date` (string, required): Date in YYYY-MM-DD format
    - `amount` (number, required): Total cost for this day
  - `total` (number, required): Total cost for the period
  - `providers_covered` (array of string): Cloud providers these totals span. This series is the one spend reader that covers every connected cloud at once, so a figure from it is not comparable with one from a single-provider endpoint unless this says it is.

#### Errors

- `400`: Bad Request
- `401`: Authentication Error
- `403`: Authorization Error
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

Body of `400`, `401`, `403`, `404`, `409`, `422`, `429`, `500`:

- `success` (`false`, required)
- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `details` (any)
- `timestamp` (date-time string, required)