# List lead lists

`GET https://app.whatsetter.com/api/v1/lists`

Requires scope `lists:read`.

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/lists' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The workspace's lists

```json
{
  "data": [
    {
      "id": "",
      "name": "",
      "status": "",
      "total_rows": 0,
      "valid_leads": 0,
      "invalid_leads": 0,
      "keep_open": false,
      "created_at": ""
    }
  ]
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listlists/
