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

Filter by Reserved Instance lifecycle state. Omit to include all states.

Filter by exact EC2 instance type (for example, m5.large). Case-sensitive. Must match the instanceType value on the RI exactly.

Filter by EC2 instance family, the leading segment of instanceType before the dot (for example, m5 matches m5.large and m5.xlarge). Case-sensitive.

Filter by AWS region (for example, us-east-1). Case-sensitive. Must match the region stored on the RI.

Filter by RI offering class. Omit to include both standard and convertible.

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.

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.

Generated from available response content types