Bounce

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

Emails will no longer be sent to the addresses in the list.

You can query and delete addresses in the list.

---

Query

URL

https://api2.sendcloud.net/api/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
days	int	*	stats in the past [days] days (days=1means 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	amount, [0-100], defaults to 100
limit	int	no	amount, [0-100], defaults to 100

Tips:

1. With designated time span, you are to search within the period of time. Note: start_date and end_date, or [days] is required.
2. Time frame cannot be longer than 3 months.
3. With given email address, you are to learn more about this email address in the bounce list. Note: time frame is invalid now.

Request Example:

https://api2.sendcloud.net/api/bounce/list?apiUser=***&apiKey=***&days=100&start=0

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

Returned Value Description

parameter	description
email	email address
reason	bounce reason
domain	bounce domain
bounceTime	bounce time
expireTime	expire time

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",
       "domain":"qq.com",
	   "bounceTime":"2016-02-01 14:53:20",
	   "expireTime": "2021-07-09 00:59:37"
       }
    ],
    "count":1
    }
  "message":"request was successful",
  "result":true
  }

---

Delete

The function of deleting the interface is the same as that of adding the interface in sending uninterception. It is recommended that customers with this requirement call the adding interface in sending uninterception

URL

https://api2.sendcloud.net/api/bounce/delete

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	yes	email addresses to uninterception

Tips:

1. With designated time span, you are to search within the period of time. Note: start_date and end_date, or [days] is required.
2. Time span cannot be longer than 3 months.
3. With given email address, you are to delete this email address in the bounce list. Note: time span is invalid now.

Request Example

https://api2.sendcloud.net/api/bounce/delete?apiUser=***&apiKey=***&email=***

Return Value Description

parameter	description
count	count of uninterception addresses

Return Value Example

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