Returns ID number and statistics for one mailing list. Statistics include number of subscribers, number of contacts who have unsubscribed, and the number of autoresponders associated with each list.
XML Request Example:
<?xml version="1.0" encoding="UTF-8"?>
<xmlrequest>
<username>JohnDoe</username>
<usertoken>abc123abc123abc123abc123</usertoken>
<requesttype>Lists</requesttype>
<requestmethod>findlist</requestmethod>
<details>
<!-- either list name OR list ID must be provided -->
<list>123456</list>
<name>list1</name>
</details>
</xmlrequest><xmlrequest> element
| Field Name | Description |
| username | Username used to login to Pinpointe |
| usertoken | Unique token assigned to Pinpointe account |
| requesttype | Lists |
| requestmethod | findlist |
Please note: ALL OPTIONAL tags that are not used should be deleted from submitted call. For example, if <list> tag is used, <name></name> should be deleted.
<details> element
| Field Name | Description |
| list (Required if <name> tag not used) | Find the database mailing list with this ID number. |
| name (Required if <list> tag not used) | Find the database mailing list with this name. |
Successful Response:
<response> element
| Field Name | Description |
| status | Will return SUCCESS if list was successfully found |
| data | Contact ID number |
Unsuccessful Response:
<response> element
| Field Name | Description |
| status | Will return ERROR when unsuccessful |
| errormessage | Text explaining why request failed |