# `list_images`
<a name="pc-py-lib-api-image-list"></a>

```
list_images(image_status, region, next_token)
```

Retrieve the list of existing images.Parameters:

**`image_status` (required)**  
Filters by image status.  
Valid values: `AVAILABLE` \$1 `PENDING` \$1 `FAILED`

**`region`**  
Lists images built in a given AWS Region.

**`next_token`**  
The token for the next set of results.