> For the complete documentation index, see [llms.txt](https://kasplo.gitbook.io/kasplo-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kasplo.gitbook.io/kasplo-doc/channels/email-marketing/get-list-api.md).

# GET List API

### Endpoint:

```
GET {domain}/audience/v1/{sid}/list
```

### Sample CURL:

```

  curl --location '{domain}/audience/v1/{sid}/list' \
--header 'api-key: {api-key}'
  
```

### Response:

```

  {
    "data": [
        {
            "name": "list-4",
            "list_id": "229dc5317d78a2ab45ac641a5a4de156",
            "status": 1,
            "created_at": "2024-11-18T18:08:20Z",
            "updated_at": "2024-11-18T18:08:20Z"
        }
    ],
    "limit": 10,
    "message": "Request processed successfully.",
    "status": 200,
    "total": 1
}

  
```

### Fields:

* **name:** List name<br>
* **list\_id:** Unique list identifier<br>
* **status: 1** = active<br>
* **created\_at / updated\_at:** Timestamps in UTC