# RI recommendation cooldown schedule

Returns the configured minimum interval between RI recommendation engine runs and when the next run becomes eligible, based on the latest completed approval transaction for the account and service.

Endpoint: GET /gateway/lw/api/accounts/{account_id}/v1/events/ri_recommendation_schedule
Version: 1.0
Security: x-api-key

## Path parameters:

  - `account_id` (string, required)
    Account Identifier for the Entity

## Query parameters:

  - `service` (string)
    AWS Service type
    Enum: "Amazon Elastic Compute Cloud - Compute", "Amazon Relational Database Service", "Amazon ElastiCache"

## Response 200 fields (application/json):

  - `ts` (integer)
    Response timestamp

  - `success` (boolean)
    Specifies if the operation is successful

  - `errors` (string)
    Specifies the error if the operation failed

  - `response` (object)

  - `response.minIntervalDays` (integer)
    Minimum calendar days after the last completed RI approval transaction before a non-force recommendation run proceeds

  - `response.lastTransactionAt` (string)
    Omitted when no qualifying completed approval transaction exists (e.g. recommendation job never ran or none completed yet). Otherwise, updated time of the latest transaction used for cooldown.

  - `response.nextEligibleAt` (string)
    Earliest time a non-force run clears the cooldown; omitted when there is no prior transaction or cooldown is disabled

  - `response.isEligibleNow` (boolean)
    Whether a non-force recommendation run would not be skipped for cooldown reasons

  - `response.lastRunCompletedAt` (string)
    When the latest completed RI recommendation engine job finished for this cloud account and service

  - `response.recommendationsGenerated` (integer)
    Number of RI recommendations enqueued in that last completed run

  - `response.noNewRecommendationsReason` (string)
    When no new recommendations were produced, machine-readable reason (e.g. target_coverage_achieved, guardrails_validation_failed, pending_jobs_or_cooldown, recommendation_cooldown, no_forecast_data)

  - `response.noNewRecommendationsReasonMessage` (string)
    Default English explanation for the UI when noNewRecommendationsReason is set; clients may localize using noNewRecommendationsReason as the key


## Response 400 fields