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.


JSON Request Example:      

{
  "username": "JohnDoe",
  "usertoken": "abc123abc123abc123abc123",
  "requesttype": "Lists",
  "requestmethod": "FindList",
  "details": {
    /* one of list or name is required */
    "list": "{*list_id*}",
    "name": "{*list_name*}"
  }
}
Null

"json_request"  element


Field NameDescription
usernameUsername used to login to Pinpointe
usertokenUnique token assigned to Pinpointe account
requesttypeLists
requestmethodFindList


Please note: ALL OPTIONAL elements that are not used should be deleted from submitted call. For example, if "list" element is used, "name": "{*list_name*}" should be deleted. 


"details" element


Field NameDescription
list
(Required if "name" element not used)
Find the database mailing list with this ID number. 
name
(Required if "list" element not used)
Find the database mailing list with this name. 



Successful Response:


"response" element


Field NameDescription
statusWill return SUCCESS if list was successfully found
dataContact ID number


Unsuccessful Response:


"response" element


Field NameDescription
statusWill return ERROR when unsuccessful
errormessage

Text explaining why request failed