# Get provider spending summary

> Returns spending summary for a specific cloud provider

Source: https://docs.levelfour.ai/api-reference/providers/get-providers-by-id-costs-summary


## GET /api/v1/providers/{provider_id}/costs/summary

Returns spending summary for a specific cloud provider

### Authentication

Send `Authorization: Bearer <token>`.

### Parameters

- `provider_id` (path, string, required)
- `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): Provider-specific spending summary
  - `provider_id` (string, required): Provider identifier: aws, gcp, azure, k8s
  - `provider_name` (string, required): Display name
  - `monthly_spending` (number, required): Current month spending
  - `monthly_spending_percentage` (number, nullable): MoM change percentage
  - `forecasted_monthly_costs` (number, required): Projected full month costs based on daily run rate
  - `forecasted_monthly_costs_percentage` (number, nullable): Forecast vs previous month actual percentage
  - `potential_savings` (number, required): Total potential savings for this provider
  - `potential_savings_percentage` (number, required): Savings as percentage of spending
  - `top_services` (array of object, required): Top 3 services by cost
    - `service` (string, required): Service name
    - `cost` (number, required): Current period cost
    - `change_percentage` (number, nullable): Change from previous period
  - `credits_summary` (object, nullable): Gross, credits and net for this month and last. Google Cloud only.
    - `gross` (number, required): Month-to-date cost before credits
    - `credits` (number, required): Month-to-date credits, zero or negative
    - `net` (number, required): Month-to-date cost after credits
    - `previous_gross` (number, required): Last month's cost before credits
    - `previous_credits` (number, required): Last month's credits, zero or negative
    - `previous_net` (number, required): Last month's cost after credits
    - `credits_pct_of_gross` (number, nullable): Share of this month's gross cost covered by credits
  - `credits` (one of `before`, `after`, nullable): Cost basis applied: after or before Google Cloud credits

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