get
https://api.aurorasendcloud.com/api/emails/status
Check status of emails in the list
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Guidelines
Time Period Requirements
- Required: You must specify either
startDateandendDateparameters, or thedaysparameter - Maximum duration: Time span cannot exceed 3 days
- Date format: Use yyyy-MM-dd format for
startDateandendDate
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: 60 requests per minute per user account
- Exceeded limit response:
{"result": false, "statusCode": 50000, "message": "interface frequency limited", "info": {}}
Status Parameters
- Valid status values: sending, delivered, suppressed, hard_bounce, soft_bounce
- Label priority: When both
labelIdandlabelNameare provided,labelIdtakes precedence for accurate queries - Label search: Use
labelNamealone for fuzzy search functionality
Status Codes Reference
Detailed Status Mapping
| Status | Sub Status | Sub Status Description |
|---|---|---|
| hard_bounce | 403 | Server Unreachable |
| hard_bounce | 404 | Address Format Error |
| hard_bounce | 405 | IP, Domain Name Rejected |
| hard_bounce | 406 | Address Does Not Exist |
| hard_bounce | 407 | Spam |
| hard_bounce | 408 | Sender/Recipient Rejected |
| hard_bounce | 409 | Other |
| Status | Sub Status | Sub Status Description |
|---|---|---|
| soft_bounce | 503 | Soft Bounce - Server Error |
| soft_bounce | 505 | Soft Bounce - IP Rejection |
| soft_bounce | 506 | Soft Bounce - Not Exist |
| soft_bounce | 507 | Soft Bounce - Spam Rejection |
| soft_bounce | 508 | Soft Bounce - Rejection |
| soft_bounce | 509 | Soft Bounce - Others |
| Status | Sub Status | Sub Status Description |
|---|---|---|
| suppressed | 401 | SendCloud Blacklist |
| suppressed | 402 | Unsubscribe |
Response Classification
Suppressed or Hard Bounce
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
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 suppressed and hard bounce emails (4xx sub-status) from your mailing lists
- Use pagination for large datasets to avoid timeouts
- Respect rate limits to ensure consistent API access
note
This API is the upgraded version of Get Emails Status with some status values added and removed. The original endpoint is marked deprecated and still usable.