---
title: "Get an AWS recommendation"
method: GET
path: "/ps4commitments/v1/aws/payer-accounts/{payerAccountId}/recommendations/{serviceId}"
tags: ["PS4Commitments AWS"]
---

# Get an AWS recommendation

`GET /ps4commitments/v1/aws/payer-accounts/{payerAccountId}/recommendations/{serviceId}`

Returns full detail for a single recommendation including analysis metrics.

## Path parameters

- `payerAccountId` string, required
- `serviceId` 'compute' | 'database', required

## Query parameters

- `granularity` 'hour' | 'day' | 'week' | 'month'

## Headers

- `X-Tenant-Id` string

## Response `200`

Recommendation detail.

- AwsRecommendationWithEligibleSpend — Service recommendation with eligible spend data
  - `recommendation` AwsRecommendation — Recommended commitments
    - `policy` string — Actual configured policy
    - `currentCommitment` number, double — Active commitments currently applied to this account, measured in hourly spend.
    - `recommendedCommitment` number, double — Recommended hourly commitment level based on usage patterns and your commitment policy, designed to increase savings while managing underutilization risk.
    - `potentialAdditionalSavings` number, double — Estimated additional monthly savings from applying the recommended commitment policy.
    - `estimatedAverageCoverage` number, double — Estimated average coverage.
    - `estimatedEquivalentRecommendedCommitment` number, double — Estimated shelf-price hourly equivalent of the recommended commitment, derived from the median hourly eligible usage over the last 60 days multiplied by the estimated average coverage.
  - `eligibleUsage` EligibleSpendDataPoint[]
    - `usageTime` string, date-time, nullable
    - `totalUsage` number, double — Total usage.
    - `minUsage` number, double — Min usage.
    - `maxUsage` number, double — Max usage.
    - `medianUsage` number, double — Median usage.

## Other responses

- `400` — Syntactically malformed request, missing required parameter, or unsupported parameter value.
- `401` — Missing or invalid credentials.
- `403` — Authenticated but not authorised to access this customer's PS4C resources.
- `404` — The requested resource does not exist.
- `500` — Unexpected server error.
- `503` — Service temporarily unavailable; retry after the indicated delay.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)