## List History

**get** `/v2/droplets/autoscale/{autoscale_pool_id}/history`

To list all of the scaling history events of an autoscale pool, send a GET request to `/v2/droplets/autoscale/$AUTOSCALE_POOL_ID/history`.

The response body will be a JSON object with a key of `history`. This will be
set to an array containing objects each representing a history event.

### Returns

- **meta:** `MetaProperties`

  Information about the response itself.

- **history:** `array of object`

  - **created\_at:** `string`

    The creation time of the history event in ISO8601 combined date and time format.

  - **current\_instance\_count:** `number`

    The current number of Droplets in the autoscale pool.

  - **desired\_instance\_count:** `number`

    The target number of Droplets for the autoscale pool after the scaling event.

  - **history\_event\_id:** `string`

    The unique identifier of the history event.

  - **reason:** `"CONFIGURATION_CHANGE" OR "SCALE_UP" OR "SCALE_DOWN"`

    The reason for the scaling event.

    - `"CONFIGURATION_CHANGE"`

    - `"SCALE_UP"`

    - `"SCALE_DOWN"`

  - **status:** `"in_progress" OR "success" OR "error"`

    The status of the scaling event.

    - `"in_progress"`

    - `"success"`

    - `"error"`

  - **updated\_at:** `string`

    The last updated time of the history event in ISO8601 combined date and time format.

- **links:** `PageLinks`