List AWS Savings Plans

Returns the paginated list of Savings Plans for the specified MPA.
Filterable by plan type and state.

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

AWS Master Payer Account ID (12-digit AWS account number) that scopes the request.

Query Params
string
enum

Filter by Savings Plan type.

Allowed:
string
enum

Filter by Savings Plan state.

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

Tenant (customer) identifier that conveys the tenant scope for the request
(DoiT API Design Standards §15).

Resolution when the header is absent:

  • A key scoped to exactly one tenant resolves to that tenant automatically; the header is
    optional.
  • A principal that can access more than one tenant (e.g. DoiT-employee keys) must supply the
    header. Without it the request is rejected with 400 and code tenant_id_required — the
    server does not guess across tenant scopes.

When the header is present but conflicts with the tenant the key is scoped to, the request is
rejected with 400 and code tenant_id_mismatch.

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