Spam Report

For spam reported by a user, the user's address will enter the spam report list The email addresses in this list will be blocked by the system, and the failures will be classified as 无效邮件-在SendCloud黑名单中:退信(worker:address in complaint list)

You can query and delete this list

---

QUERY

URL

https://api.sendcloud.net/apiv2/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); cannot be more than 30 days
startDate	string	*	format of start date is yyyy-MM-dd，interval between start and end date cannot be more than 30 days
endDate	string	*	format of end date is yyyy-MM-dd，interval between start and end date cannot be more than 30 days
email	string	*	Query the details of the address in the report list
start	int	no	start position, [0-], defaults to 0
limit	int	no	amount, [0-100],defaults to 100

Tips:

1. If a time interval is specified, the report list within this time interval will be queried. Note: * start_ Date and end_ Date combination * or * days parameter * , whichever is one
2. The number of days to query is not more than three months.
3. If email is specified, the details of this address in the report list will be queried. Note: at this time, the time interval parameter is invalid

Request Example:

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

Returned Value Description

parameter	description
email	Reporting address
reason	Reporting reason
domain	Reporting address domain
complaintTime	Reporting time
expireTime	When the sendcloud blacklist expires

Return value example

{
    "result": true,
    "statusCode": 200,
    "message": "请求成功",
    "info": {
        "dataList": [
            {
                "email": "demo@gmail.com",
                "reason": "FROM ESP",
                "domain": "",
                "complaintTime": "2021-06-19 15:31:49",
                "expireTime": "2023-07-19 15:31:53"
            }
        ],
        "count": 1
    }
}

---

Delete

URL

https://api.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	*	Delete the specified message

提示:

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 mailbox

请求示例:

https://api.sendcloud.net/apiv2/complaint/delete?apiUser=***&apiKey=***&email=****

返回值说明

无

返回值示例

{
    "result": true,
    "statusCode": 200,
    "message": "请求成功",
    "info": {
        "count": 1
    }
}