Complaint

When the recipient reports your email as spam, his email address will be added to the list of spam reporting.

Email addresses in this list will be intercepted until the expiration time.

You may search in the spam list.

---

Query

URL

https://api2.sendcloud.net/api/complaint/list

HTTP Request Method

post    get

Parameter Description

parameter	type	required or not	description
apiUser	string	yes	API_USER
apiKey	string	yes	API_KEY
days	int	*	stats in the past [days] days (days=1 means today
startDate	string	*	format of start date is yyyy-MM-dd
endDate	string	*	format of end date is yyyy-MM-dd
email	string	*	learn more about the address in the list
start	int	no	start position, [0-], defaults to 0
limit	int	no	amount, [0-100],defaults to 100

Tips:

1. With designated time span, your search should be within the period. Note: start_date and end_date or days is required.
2. Time span cannot be longer than 3 months.
3. With given email address, your search in spams should provide the details of this email. Note: time span will turn to invalid now.

Request Example:

https://api2.sendcloud.net/apiv2/complaint/list?apiUser=***&apiKey=***

Returned Value Description

None

Returned Value Example

{
    "statusCode":200
    "info":{
      "dataList":[
         {
            "receiver":"9978977@qq.com",
            "reason":"from softbounce",
            "spamReportedTime":"2016-02-22 14:40:25",
            "domain":"qq.com"
         }
       ],
      "count":1
     },
     "message":"request was successful",
     "result":true

}

---

Delete

URL

https://api2.sendcloud.net/apiv2/complaint/delete

HTTP Request Method

post    get

Parameter Description

parameter	type	required or not	description
apiUser	string	yes	API_USER
apiKey	string	yes	API_KEY
startDate	string	*	format of start date is yyyy-MM-dd
endDate	string	*	format of end date is yyyy-MM-dd
email	string	*	email addresses to delete

Tips:

1. email and (startDate and enddate) cannot be empty at the same time. If email is empty, the addresses within the specified time (startDate and enddate) will be deleted
2. If email is not empty, delete the address of the specified address

Request Example:

https://api2.sendcloud.net/apiv2/complaint/list?apiUser=***&apiKey=***&email=****

Returned Value Description None

Returned Value Example

{
    "statusCode":200
    "info":{      
      "count":1
     },
     "message":"request was successful",
     "result":true
}