get
https://api.aurorasendcloud.com/api/data/emailStatus
Check status of emails in the list
Important Guidelines
API Usage Tips
Time Period Requirements
- Required: You must specify either
start_dateandend_dateparameters, or thedaysparameter - Maximum duration: Time span cannot exceed 3 days
- Date format: Use yyyy-MM-dd format for start_date and end_date
Pagination and Limits
- Default limit: 100 records per search
- Pagination: Use
limitandstartparameters when records exceed 100 - Cache duration: Each query result is cached for 10 minutes
Rate Limiting
- Maximum calls: 3,000 requests per minute per user account
- Exceeded limit response:
{"result": false, "statuscode": 50000, "message": "interface frequency limited", "info": {}}
Status Parameters
- Valid status values: 1 (delivered), 4 (invalid email), 5 (soft bounce), 18 (sending)
- Label priority: When both
labelIdandlabelNameare provided,labelIdtakes precedence for accurate queries - Label search: Use
labelNamealone for fuzzy search functionality
Status Codes Reference
Sub-Status Codes Overview
| Sub Status | Description |
|---|---|
| 401 | Blacklist |
| 402 | Unsubscribe |
| 403 | Server error |
| 404 | Format error |
| 405 | IP rejection |
| 406 | Not Exist |
| 407 | Junk mail |
| 408 | Rejection |
| 409 | Others |
| 503 | Soft bounce - Server error |
| 505 | Soft bounce - IP rejection |
| 506 | Soft bounce - Not Exist |
| 507 | Soft bounce - Spam rejection |
| 508 | Soft bounce - Rejection |
| 509 | Soft bounce - Others |
Detailed Status Mapping
| Status | Sub Status | Sub Status Description |
|---|---|---|
| Invalid Mail - Platform Blacklist | 401 | SendCloud Blacklist |
| Invalid Mail - Unsubscribe | 402 | Unsubscribe |
| Invalid Mail - Server Unreachable | 403 | Server Unreachable |
| Invalid Mail - Address Format Error | 404 | Address Format Error |
| Invalid Mail - IP/Domain Rejected | 405 | IP, Domain Name Rejected |
| Invalid Mail - Address Does Not Exist | 406 | Address Does Not Exist |
| Invalid Mail - Spam | 407 | Spam |
| Invalid Mail - Sender/Recipient Rejected | 408 | Sender/Recipient Rejected |
| Invalid Mail - Other | 409 | Other |
Response Classification
Invalid Email (4xx)
Sub-status codes in the 4xx range indicate permanent delivery failures. These emails should not be retried as they represent issues like invalid addresses, blacklists, or permanent rejections.
Soft Bounce (5xx)
Sub-status codes in the 5xx range indicate temporary delivery failures. These emails may be retried after addressing the underlying issue (server problems, temporary blocks, etc.).
Best Practices
- Monitor sub-status codes to understand delivery failures
- Handle soft bounces by implementing retry logic with appropriate delays
- Remove invalid emails (4xx sub-status) from your mailing lists
- Use pagination for large datasets to avoid timeouts
- Respect rate limits to ensure consistent API access