List AWS Reserved Instances recommendations

Return AWS Reserved Instance recommendations matching the supplied filters. Without page or limit, at most 5000 results are returned. Supplying either enables pagination with default page 1 and default limit 50 (maximum 5000). Use the returned pagination metadata to retrieve additional pages. Monetary response fields use the tenant preferred currency (USD fallback), identified by estimatedCurrency; the minimum savings filter is applied to stored amounts before conversion. Recommendations refresh periodically.

Paging does not guarantee a stable ranking across requests. These filters and paging inputs apply only to Reserved Instances, not Savings Plans. Reads do not generate recommendations or purchase commitments.

Query Params
uuid
required
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Organization identifier

string
length ≥ 1

Filter by integration identifier

string
enum

Filter by account scope

Allowed:
integer
1 to 5000

Page size, at most 5000. Defaults to 50 when page is supplied; without page and limit, returns at most 5000 results.

string
enum

Filter by recommendation lookback period

Allowed:
number
≥ 0

Minimum savings in the stored recommendation currency, before response currency conversion

number
0 to 100

Minimum utilization percentage

string
enum

Filter by offering class

Allowed:
string
enum

Filter by payment option

Allowed:
integer
≥ 1

Page number, starting at 1; defaults to 1

string
enum

Filter by service type

string
enum

Filter by reservation term

Allowed:
Responses

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