# Get Savings Audit summary

> Returns enhanced BigNumbers data for the Savings Audit page

Source: https://docs.levelfour.ai/api-reference/audit/get-recommendations-audit-summary


## GET /api/v1/recommendations/audit/summary

Returns enhanced BigNumbers data for the Savings Audit page

### Authentication

Send `Authorization: Bearer <token>`.

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (date-time string)
- `data` (object, required): Savings Audit summary data - simplified for UI BigNumbers
  - `total_monthly_savings` (number, required): Combined monthly savings run rate across every implemented recommendation. Each ledger row carries a recommendation's monthly rate once, in the month it was applied, so this spans several billing periods and is still a monthly figure.
  - `total_monthly_savings_percentage` (number, nullable): Change in the monthly run rate from the previous billing period to the latest one
  - `total_annual_savings` (number, required): The monthly run rate multiplied by 12
  - `payback` (number, nullable): Payback period in months
  - `average_roi` (number, required): Average ROI percentage
  - `total_savings` (number, required): Total savings annualized, the figure LevelFour bills against. Equal to total_annual_savings. Not an inception-to-date accumulation, and note that providers[].total_savings is the monthly run rate rather than an annual figure.
  - `providers` (array of object): Per-provider savings breakdown for filtering
    - `provider_id` (string, required): Provider identifier: aws, gcp, azure, k8s
    - `provider` (string, required): Display name: AWS, GCP, etc.
    - `total_savings` (number, required): Total monthly savings for this provider
  - `by_implementation_method` (map of string to number): Realized savings grouped by implementation_method (one-click, one-click-plus-iac, iac, manual)
  - `by_module` (array of object): Open savings opportunity grouped by module ('cloud', 'commitments')
    - `id` (string, required): Module identifier: 'cloud' or 'commitments'
    - `monthly_savings` (number, required): Monthly savings attributed to this module
    - `open_recommendations` (integer, required): Count of pending recommendations in this module

#### 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)