Retrieve all lists
http(s)://edm.source-ec.com/api/<api_key>/list
Retrieve all lists, no paging (we don't expect that you get hundreds of thousands of lists).
Response
{
"totalRecords": 30,
"lists": [
{
"total": 2,
"id": 41,
"valid": 1,
"unsubscribed": 0,
"description": "",
"name": "email list 1",
"bounced": 1,
"createDt": "2010-07-27 09:19 AM"
},
{
"total": 100,
"id": 56,
"valid": 100,
"unsubscribed": 0,
"description": "",
"name": "email list 2",
"bounced": 0,
"createDt": "2010-10-15 04:11 PM"
},
...
]
}
A brief explanation
total: Total number of contacts in the list (include bounced, un-subscribed and deleted contacts)
valid: Number of subscribed contacts (all subscribers, probably you would like to get this value)
unsubscribed: Number of un-subscribed contacts
bounced: Number of bounced records
Retrieve list
http(s)://edm.source-ec.com/api/<api_key>/list/<list_id>
Response
{
"total": 2,
"id": 41,
"valid": 1,
"unsubscribed": 0,
"description": "",
"name": "email list 1",
"bounced": 1,
"createDt": "2010-07-27 09:19 AM"
}