# List

Launch stage: GA

`GET /api/2.0/instance-pools/list`

Gets a list of instance pools with their statistics.

API scopes: instance-pools

## Returns

Returns a list of InstancePoolAndStats objects.

## Response

```json
{
  "instance_pools": [
    {
      "stats": {},
      "status": {},
      "instance_pool_id": "string",
      "default_tags": {},
      "state": "string",
      "instance_pool_name": "my-pool",
      "min_idle_instances": 5,
      "max_capacity": 200,
      "aws_attributes": {},
      "node_type_id": "string",
      "custom_tags": {},
      "idle_instance_autotermination_minutes": 30,
      "enable_elastic_disk": true,
      "disk_spec": {},
      "preloaded_docker_images": [
        {}
      ],
      "preloaded_spark_versions": [
        "string"
      ],
      "azure_attributes": {},
      "gcp_attributes": {},
      "node_type_flexibility": {},
      "remote_disk_throughput": 0,
      "total_initial_remote_disk_size": 0
    }
  ]
}
```