---
title: "List payer account engine settings"
method: GET
path: "/ps4commitments/v1/aws/settings"
tags: ["PS4Commitments AWS"]
---

# List payer account engine settings

`GET /ps4commitments/v1/aws/settings`

Returns automation and recommendation engine settings for every onboarded
payer account, broken down by product line (`compute`, `database`).
Settings are configured at the customer level and apply uniformly across all payer accounts.
Only product lines that are activated/onboarded for a given payer account are returned.
The `purchaseAccountId` is the linked AWS account designated to execute SP
purchases on behalf of that payer account.

## Query parameters

- `pageToken` string
- `maxResults` integer

## Headers

- `X-Tenant-Id` string

## Response `200`

List of per-payer-account per-product-line engine settings.

- object
  - `items` AwsPayerAccountSettingsItem[], required
    - `payerAccountId` string, required — 12-digit AWS Master Payer Account ID.
    - `purchaseAccountId` string, nullable, required — Linked AWS account used to execute SP purchases for this payer account. Null if not configured.
    - `services` AwsPayerAccountServiceSettings[], required — Settings for each activated product line.
      - `service` 'compute' | 'database', required — Product line these settings apply to.
      - `settings` AwsPayerAccountSettings, required — Automation and recommendation engine settings for one product line.
        - `purchaseMode` 'autonomous' | 'requires_approval', required — Whether purchases execute automatically or require approval.
        - `minimumCommitment` number, double, required — Minimum hourly commitment amount (USD) per purchase step.
        - `lastDayOfMonthForPurchase` integer, required — Latest calendar day of the month on which a purchase may be scheduled.
        - `maximumCommitment` number, double, required — Maximum total hourly commitment (USD). 0 means no cap.
        - `term` 'one_year' | 'three_year', required — Commitment term length.
        - `paymentOption` 'no_upfront' | 'partial_upfront' | 'all_upfront', required — Payment structure for a commitment. - `no_upfront` — all charges paid monthly - `partial_upfront` — a portion paid upfront; remainder monthly - `all_upfront` — full commitment paid upfront
        - `policy` 'conservative' | 'balanced' | 'max_savings', required — Coverage target policy. - `conservative` — lower coverage target (~65%) - `balanced` — moderate coverage target (~80%) - `max_savings` — aggressive coverage target (~90%)
        - `upfrontPercentage` number, double — Fraction of the hourly commitment paid upfront (0–1). Only present when paymentOption is `partial_upfront`.
  - `pageToken` string, nullable — Opaque cursor for the next page. Absent when this is the last page.
  - `rowCount` integer — Number of items returned in this page.

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