Bounce Address

Emails bounced for some specific reasons (for example, email address does not exist) will be added to the bounce list.

The email addresses in this list will be blocked by the system, and the failures will be classified as 无效邮件-在SendCloud黑名单中:退信(worker:address in bounce list).

You can query and delete addresses in the list.

---

Query

URL

https://api.sendcloud.net/apiv2/bounce/list

HTTP Request Method

post    get

Parameter Description

parameter	type	required or not	description
apiUser	string	yes	API_USER
apiKey	string	yes	API_KEY
email	string	no	Query the details of the address in the return list
days	string	*	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
start	string	no	start position, [0-], defaults to 0
limit	int	no	amount, [0-100],defaults to 100

TIPS:

1. When obtaining data, you must specify a time interval. That is, the combination of StartDate and enddate or days parameter requires one of the two
2. This interface only returns the return address that has been sent under your account. When the sendcloud blacklist is intercepted, it is queried according to the return address of the whole platform.
3. By default, only 100 records are queried for each query. If the number of records that meet the criteria exceeds 100, you need to manually specify the start and limit parameters
4. Email is an optional parameter. When it is not filled in, it is to pull the return address in batch; When filling in, query the details of the address in the return list.

Request Example:

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

Returned Value Description

parameter	description
email	email address
reason	bounce reason
bounceTime	bounce time
expireTime	When the sendcloud black name expires
domain	bounce domain

Returned Value Example

 {
  "statusCode":200,  
  "info":{
    "dataList":[
       {
       "email":"b@qq.com",
       "reason":"Mailbox not found. http://service.mail.qq.com/cgi-bin/help?subtype=1&&id=20022&&no=1000728",
       "bounceTime":"2021-06-28 08:59:34",
       "domain":"qq.com",
       "expireTime": "2021-07-09 00:59:37"
       }
    ],
    "count":1
    }
  "message":"请求成功",
  "result":true
  }