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

# Get an AWS payer account

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

Returns a single Master Payer Account including metadata, 30-day aggregates,
and the trailing-window stats that drive the customer Overview screen:
- `monthlyStats` — last 6 calendar months (ESR, on-demand cost, cost with savings).
- `dailyCoverage` — last 30 days of commitment coverage breakdown.
- `savingsTotals` — year-to-date and lifetime savings per SP type.
- `monthlyPotentialSavings` — estimated monthly additional savings per SP type from the latest projection.

## Path parameters

- `payerAccountId` string, required

## Headers

- `X-Tenant-Id` string

## Response `200`

Master Payer Account detail.

- AwsPayerAccountDetail — Single Master Payer Account detail. Adds the trailing-window stats that drive the DoiT Console overview screen on top of the list-item shape: - `monthlyStats` — last 6 calendar months per SP type - `dailyCoverage` — last 30 days per SP type `savingsTotals` (precomputed YTD and lifetime savings per SP type) and `monthlyPotentialSavings` (estimated monthly additional savings per SP type) are inherited from the list-item shape (`AwsPayerAccount`).
  - `payerAccountId` string, required — 12-digit AWS Master Payer Account ID.
  - `displayName` string, nullable — Human-readable account alias, if available.
  - `onboardingStatus` AwsOnboardingStatus — PS4C onboarding state grouped by product line. A product line is omitted when it is not onboarded at all.
    - `compute` AwsOnboardingStatusEntry — Per-product-line PS4C onboarding state.
      - `status` 'not_started' | 'onboarding' | 'done' | 'error', required — Current onboarding lifecycle stage for this product line.
      - `onboardingStartedAt` string, date-time, nullable — When PS4C first began tracking commitments for this product line. Used to bound lifetime savings totals and to render onboarding history in the DoiT Console.
    - `database` AwsOnboardingStatusEntry — Per-product-line PS4C onboarding state.
      - `status` 'not_started' | 'onboarding' | 'done' | 'error', required — Current onboarding lifecycle stage for this product line.
      - `onboardingStartedAt` string, date-time, nullable — When PS4C first began tracking commitments for this product line. Used to bound lifetime savings totals and to render onboarding history in the DoiT Console.
  - `savingsPlansSyncTime` string, date-time, nullable — Timestamp of the last successful Savings Plan inventory sync.
  - `stats30d` object — Trailing 30-day aggregate metrics, broken down by SP type.
    - `compute` Stats30dSummary — Minimal 30-day aggregate. Only `esr` and `savings` are persisted at this granularity. Responses are denominated in USD. Used by both AWS payer/linked-account and GCP billing-account list items.
      - `esr` number, double, nullable — Effective Savings Rate over the last 30 days (0–1).
      - `savings` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
    - `database` Stats30dSummary — Minimal 30-day aggregate. Only `esr` and `savings` are persisted at this granularity. Responses are denominated in USD. Used by both AWS payer/linked-account and GCP billing-account list items.
      - `esr` number, double, nullable — Effective Savings Rate over the last 30 days (0–1).
      - `savings` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
  - `savingsTotals` object — Year-to-date and lifetime savings per SP type. Same figures the detail endpoint returns — surfaced on the list item so callers can compute customer-level totals (sum across payer accounts) without an extra round-trip per MPA. Lifetime is bounded by each payer account's PS4C onboarding start.
    - `compute` AwsSavingsTotals — Running savings figures derived server-side from the full monthly stats history (`onDemandCost - costWithSavings` per month, optionally bounded by onboarding start date and start of year).
      - `ytd` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `lifetime` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
    - `database` AwsSavingsTotals — Running savings figures derived server-side from the full monthly stats history (`onDemandCost - costWithSavings` per month, optionally bounded by onboarding start date and start of year).
      - `ytd` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `lifetime` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
  - `monthlyPotentialSavings` AwsMonthlyPotentialSavings — Estimated monthly additional savings per SP type, taken from the latest PS4C purchase projection. Unlike `savingsTotals` (realized YTD/lifetime savings), this is a forward-looking estimate of the monthly savings achievable if the recommended commitments were purchased. For linked accounts, the payer-account figure is attributed by each linked account's share of trailing-60-day SP-eligible on-demand cost. A per-SP-type value of `0.00` means the latest projection is missing, expired, or empty. The field is omitted entirely only for accounts that have never had potential savings computed.
    - `compute` Money
      - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
      - `currency` string, required — ISO 4217 currency code.
    - `database` Money
      - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
      - `currency` string, required — ISO 4217 currency code.
  - `monthlyStats` object — Trailing 6 calendar months of MPA stats, grouped by SP type.
    - `compute` AwsMonthlyStatsEntry[]
      - `month` string, required
      - `esr` number, double, required — Effective Savings Rate for the month (0–1).
      - `onDemandCost` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `costWithSavings` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
    - `database` AwsMonthlyStatsEntry[]
      - `month` string, required
      - `esr` number, double, required — Effective Savings Rate for the month (0–1).
      - `onDemandCost` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `costWithSavings` Money, required
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
  - `dailyCoverage` object — Trailing 30 days of commitment coverage, grouped by SP type.
    - `compute` AwsDailyCoverageEntry[]
      - `date` string, date, required
      - `onDemandCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `savingsPlanCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `reservedInstCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `flexsaveCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `spotCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
    - `database` AwsDailyCoverageEntry[]
      - `date` string, date, required
      - `onDemandCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `savingsPlanCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `reservedInstCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `flexsaveCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.
      - `spotCost` Money
        - `amount` string, required — Decimal monetary amount at ISO 4217 minor-unit precision (string).
        - `currency` string, required — ISO 4217 currency code.

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