List subscribers
Lists the subscribers of a list by state.
GET https://cotlet.dev/api/v1/campaign-monitor/lists/{list_id}/subscribers
read
Returns email, name, state, join date and custom fields for each subscriber, newest first. Use it to check whether an address is already on the list before add_subscriber.
Parameters
| Name | Type | Description |
|---|---|---|
| list_id string required | string | List ID from list_lists. |
| state string | string | Active, Unconfirmed, Unsubscribed, Bounced or Deleted. Default Active. |
| joined_since string | string | Only subscribers who joined on or after this date, YYYY-MM-DD. |
| cursor string | string | Next page cursor from the previous call. |
| limit integer | integer | How many items to return per page. |
Request
curl https://cotlet.dev/api/v1/campaign-monitor/lists/list_8c41d2/subscribers \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("campaign-monitor", "list_subscribers", {"list_id":"list_8c41d2"})const result = await cotlet.call('campaign-monitor', 'list_subscribers', {"list_id":"list_8c41d2"});cotlet call campaign-monitor list_subscribers --data '{"list_id":"list_8c41d2"}'Example response
{
"subscribers": [
{
"email": "ana.silva@example.com",
"name": "Ana Silva",
"state": "Active",
"joined": "2026-10-18",
"custom_fields": {
"Frequency": "Weekly"
}
}
],
"next_cursor": null
}