Skip to main content
GET
/
lists
/
{list_id}
/
subscribers
curl https://api2.ecomailapp.cz/lists/75/subscribers?page=1&per_page=20 \
  -H "key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "current_page": 1,
  "data": [
    {
      "list_id": 75,
      "email": "some1@contact.com",
      "status": 1,
      "subscribed_at": "2024-05-10T12:29:07.000000Z",
      "unsubscribed_at": null,
      "custom_fields": [],
      "groups": null,
      "source": "app",
      "subscriber": {
        "id": 1158595,
        "name": "Foo",
        "surname": "Bar",
        "email": "some1@contact.com",
        "gender": "male",
        "company": null,
        "city": "City",
        "country": "CZ",
        "phone": null
      }
    }
  ],
  "per_page": 20,
  "total": 2
}
​
list_id
integer
required
ID of the list.
​
page
integer
default:"1"
Page index.
​
status
string
default:"subscribed"
Filter by status: unsubscribed, not_confirmed, bounced, complained.
​
per_page
integer
default:"20"
Number of subscribers per page, up to 5000. We recommend keeping this at a lower number (e.g. 4000) depending on the amount of data each subscriber has.
Status values in the response: 1 = subscribed, 2 = unsubscribed, 4 = hard bounce, 5 = spam complaint, 6 = unconfirmed.
curl https://api2.ecomailapp.cz/lists/75/subscribers?page=1&per_page=20 \
  -H "key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "current_page": 1,
  "data": [
    {
      "list_id": 75,
      "email": "some1@contact.com",
      "status": 1,
      "subscribed_at": "2024-05-10T12:29:07.000000Z",
      "unsubscribed_at": null,
      "custom_fields": [],
      "groups": null,
      "source": "app",
      "subscriber": {
        "id": 1158595,
        "name": "Foo",
        "surname": "Bar",
        "email": "some1@contact.com",
        "gender": "male",
        "company": null,
        "city": "City",
        "country": "CZ",
        "phone": null
      }
    }
  ],
  "per_page": 20,
  "total": 2
}