# List auto-renewal events

Returns auto-renewal activities (upcoming and completed) for the account, filtered by date range and optional cloud account, regions, and AWS service. Used to annotate charts such as Compute Coverage when savings or coverage dip around RI/SP renewals. If start_date and end_date are omitted, the server defaults to the last 30 days (UTC).

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

## Path parameters:

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

## Request fields (application/json):

  - `cloud_account_ids` (array)
    When non-empty, only renewal events for these cloud accounts are returned

  - `start_date` (string)
    Start of filter range (YYYY-MM-DD). Defaults to 30 days before today (UTC) when omitted.
    Example: "2025-01-01"

  - `end_date` (string)
    End of filter range (YYYY-MM-DD). Defaults to today (UTC) when omitted.
    Example: "2025-01-31"

  - `regions` (array)
    When non-empty, only events whose region matches one of these values

  - `service` (string)
    AWS service type; defaults to Amazon Elastic Compute Cloud - Compute when omitted
    Enum: "Amazon Elastic Compute Cloud - Compute", "Amazon Relational Database Service"

## Response 200 fields (application/json):

  - `ts` (integer)
    Response timestamp

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

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

  - `response` (object)

  - `response.events` (array)
    Auto-renewal events in the requested range and filters

  - `response.events.id` (integer)
    Activity row identifier

  - `response.events.cloud_account_id` (string)

  - `response.events.region` (string)

  - `response.events.status` (string)
    Activity status (e.g. pending, complete)

  - `response.events.expiry_date` (string)
    Reservation expiry date from activity metadata (YYYY-MM-DD)

  - `response.events.renewal_scheduled_at` (string,null)
    Present when status indicates renewal scheduling completed; mirrors last update time

  - `response.events.updated_at` (string)
    When the activity was last updated

  - `response.events.description` (string)
    Human-readable activity description


## Response 400 fields