[ AWS CLI Command Reference ](../../index.html)

  * [ Home ](../../index.html)
  * [ User Guide ](https://docs.aws.amazon.com/cli/latest/userguide/)
  * [ Forum ](https://forums.aws.amazon.com/forum.jspa?forumID=150)
  * [ GitHub ](https://github.com/aws/aws-cli)

###  Navigation

  * [ index ](../../genindex.html "General Index")
  * [ next ](list-type-registrations.html "list-type-registrations") | 
  * [ previous ](list-stack-sets.html "list-stack-sets") | 
  * [ AWS CLI 2.15.40 Command Reference ](../../index.html) » 
  * [ aws ](../index.html) » 
  * [ cloudformation ](index.html) » 

  * [ ← list-stack-sets ](list-stack-sets.html "previous chapter \(use the left arrow\)") / 
  * [ list-type-registrations → ](list-type-registrations.html "next chapter \(use the right arrow\)")

[ ![Amazon Web Services logo](../../_static/logo.png) ](../../index.html)

###  [ Table of Contents ](../../index.html)

  * list-stacks 
    * Description 
    * Synopsis 
    * Options 
    * Global Options 
    * Examples 
    * Output 

###  Quick search

Search box  Search

###  Feedback

Did you find this page useful? Do you have a suggestion to improve the
documentation? [ Give us feedback ](https://docs.aws.amazon.com/forms/aws-doc-
feedback?hidden_service_name=AWS%20Command%20Line%20Interface&hidden_guide_name=Reference&topic_url=https%3A%2F%2Fdocs.aws.amazon.com%2Fcli%2Flatest%2Freference/cloudformation/list-
stacks.html) .  
If you would like to suggest an improvement or fix for the AWS CLI, check out
our [ contributing guide ](https://github.com/aws/aws-
cli/blob/develop/CONTRIBUTING.md) on GitHub.

###  User Guide

First time using the AWS CLI? See the [ User Guide
](https://docs.aws.amazon.com/cli/latest/userguide/) for help getting started.

[ [ aws  ](../index.html#cli-aws) . [ cloudformation  ](index.html#cli-aws-
cloudformation) ]

#  list-stacks  Â¶

##  Description  Â¶

Returns the summary information for stacks whose status matches the specified
StackStatusFilter. Summary information for stacks that have been deleted is
kept for 90 days after the stack is deleted. If no StackStatusFilter is
specified, summary information for all stacks is returned (including existing
stacks and stacks that have been deleted).

See also: [ AWS API Documentation
](https://docs.aws.amazon.com/goto/WebAPI/cloudformation-2010-05-15/ListStacks)

` list-stacks  ` is a paginated operation. Multiple API calls may be issued in
order to retrieve the entire data set of results. You can disable pagination
by providing the ` --no-paginate  ` argument. When using ` --output  text  `
and the ` --query  ` argument on a paginated response, the ` --query  `
argument must extract data from the results of the following query
expressions: ` StackSummaries  `

##  Synopsis  Â¶

    
    
      list-stacks
    [--stack-status-filter <value>]
    [--cli-input-json | --cli-input-yaml]
    [--starting-token <value>]
    [--max-items <value>]
    [--generate-cli-skeleton <value>]
    [--debug]
    [--endpoint-url <value>]
    [--no-verify-ssl]
    [--no-paginate]
    [--output <value>]
    [--query <value>]
    [--profile <value>]
    [--region <value>]
    [--version <value>]
    [--color <value>]
    [--no-sign-request]
    [--ca-bundle <value>]
    [--cli-read-timeout <value>]
    [--cli-connect-timeout <value>]
    [--cli-binary-format <value>]
    [--no-cli-pager]
    [--cli-auto-prompt]
    [--no-cli-auto-prompt]
    

##  Options  Â¶

` --stack-status-filter  ` (list)

> Stack status to use as a filter. Specify one or more stack status codes to
> list only stacks with the specified status codes. For a complete list of
> stack status codes, see the ` StackStatus  ` parameter of the Stack data
> type.
>
> (string)

Syntax:

    
    
    "string" "string" ...
    
    Where valid values are:
      CREATE_IN_PROGRESS
      CREATE_FAILED
      CREATE_COMPLETE
      ROLLBACK_IN_PROGRESS
      ROLLBACK_FAILED
      ROLLBACK_COMPLETE
      DELETE_IN_PROGRESS
      DELETE