# Get commitments overview

> ESR strip and aggregate RI/SP metrics for the requested provider (AWS real, GCP/Azure return zeros).

Source: https://docs.levelfour.ai/api-reference/commitments/get-commitments-overview


## GET /api/v1/commitments/overview

ESR strip and aggregate RI/SP metrics for the requested provider (AWS real, GCP/Azure return zeros).

### Authentication

Send `Authorization: Bearer <token>`.

### Parameters

- `provider` (query, string, default `aws`)
- `commitment_type` (query, string, default `all`)

### Responses

#### 200: Successful Response

- `success` (boolean, default `true`)
- `timestamp` (date-time string)
- `data` (object, required)
  - `global_esr` (number, required)
  - `benchmark_esr` (number, required)
  - `total_committed_monthly` (number, required)
  - `total_cloud_spend_monthly` (number, required)
  - `coverage_pct` (number, required)
  - `coverage_delta_pp` (number, required)
  - `estimated_waste_monthly` (number, required)
  - `waste_commitment_count` (integer, required)
  - `potential_additional_savings_monthly` (number, required)
  - `commitment_count` (integer, required)
  - `expiring_count` (integer, required)
  - `accounts` (array of object, required)
    - `account_id` (string, required)
    - `account_name` (string, required)
    - `monthly_spend` (number, required)
    - `esr_pct` (number, required)
    - `monthly_saved` (number, required)
    - `could_save_additional` (number, required)

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