List AWS Savings Plans

Returns a paginated list of Savings Plans for the specified AWS organization. Optionally filter by plan type (type) and state (status). Omit both filters to return all plans for the AWS organization.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^\d{12}$

12-digit AWS management (payer) account ID (the account that owns the AWS Organization) that scopes the request.

Query Params
string
enum

Filter by Savings Plan type. Omit to include all types.

Show Details
computeCompute Savings Plans that apply across eligible compute usage.
ec2_instanceEC2 Instance Savings Plans scoped to a family and region.
sagemakerSageMaker Savings Plans.
databaseDatabase Savings Plans for eligible database spend.
Allowed:
string
enum

Filter by Savings Plan lifecycle state. Omit to include all states.

Show Details
pending_returnA SP return was requested. AWS has accepted the request and is waiting to finish it.
returningAWS return is in progress.
activeSP is active and providing coverage.
expiredSP term has ended.
queuedSP is queued to start at a future time.
queued_returningQueued SP that is also pending AWS return.
payment_failedPurchase or renewal payment failed.
payment_pendingPurchase or renewal payment is pending.
string

Opaque cursor token returned by a previous list response. Omit to start from the beginning; an empty or absent token in a response means there are no more results. Do not parse it. A structurally invalid cursor returns 400 with code pagination_token_invalid; an expired cursor returns 400 with code pagination_token_expired — restart pagination from the beginning.

integer
1 to 500
Defaults to 50

Maximum number of items to return. Server may return fewer. Defaults to 50; maximum 500.

Headers
string

Customer (tenant) ID for the request. This is separate from authentication: you still pass your personal or service account API token in the Authorization header (Bearer <token>). See Get Started.

When to omit (most callers): If your personal or service account token belongs to a single customer, omit this header. The API resolves that customer from the token.

When to send: If your credential can access more than one customer, set X-Tenant-Id to the customer ID you want to act on. Omitting it returns 400 with code tenant_id_required. If the value conflicts with the tenants your credential may access, the request returns 400 with code tenant_id_mismatch. Prefer this header over the legacy customerContext query parameter, which only applies to legacy API keys and is ignored by personal and service account tokens.

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json