---
updatedAt: 2026-04-27T07:35:23.000Z
agentTools:
  projectIndex: https://docs.aurorasendcloud.com/llms.txt
---

# Status of Sending by Address List

Query the status and details of an address list email task. Address list sending is asynchronous: right after task creation the status is "Request in"; poll this endpoint until it becomes "Request completed". Task IDs are visible only in the region that created them; querying another region returns 40020.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Email"
  },
  "servers": [
    {
      "url": "https://api.aurorasendcloud.com/",
      "description": "Singapore Region\n- Base URL: https://api.aurorasendcloud.com/\n"
    },
    {
      "url": "https://api-us.aurorasendcloud.com/",
      "description": "US (Silicon Valley) Region\n- Base URL: https://api-us.aurorasendcloud.com/\n"
    },
    {
      "url": "https://api-hk.aurorasendcloud.com/",
      "description": "CN (Hong Kong SAR) Region\n- Base URL: https://api-hk.aurorasendcloud.com/\n"
    }
  ],
  "tags": [
    {
      "name": "Send Email",
      "description": "Regular delivery, templates delivery"
    }
  ],
  "paths": {
    "/api/mail/taskinfo": {
      "get": {
        "summary": "Status of Sending by Address List",
        "description": "Query the status and details of an address list email task. Address list sending is asynchronous: right after task creation the status is \"Request in\"; poll this endpoint until it becomes \"Request completed\". Task IDs are visible only in the region that created them; querying another region returns 40020.",
        "operationId": "status-of-sending-by-address-list",
        "tags": [
          "Send Email"
        ],
        "security": [
          {
            "apiUser": [],
            "apiKey": []
          }
        ],
        "parameters": [
          {
            "in": "query",
            "name": "maillistTaskId",
            "schema": {
              "type": "string",
              "pattern": "^[0-9]+$"
            },
            "required": true,
            "description": "maillistTaskId returned by a send or sendtemplate request that uses an address list (business code 40821 \"Address list task created successfully\"). Must be a positive integer; a missing value returns 40019 (\"maillistTaskId not be blank\"), a non-integer or non-positive value returns 40019 (\"maillistTaskId error\"), and a task that does not exist, belongs to another account, or was created in another region returns 40020. Values with leading zeros are normalized (e.g. \"0123\" is read as 123).",
            "example": "267131"
          }
        ],
        "responses": {
          "200": {
            "description": "Task status query successful",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 200
                    },
                    "message": {
                      "type": "string",
                      "example": "Request successful"
                    },
                    "result": {
                      "type": "boolean",
                      "example": true
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "properties": {
                            "maillistTaskId": {
                              "type": "integer",
                              "description": "Address list task ID",
                              "example": 267131
                            },
                            "apiUser": {
                              "type": "string",
                              "description": "Called apiUser",
                              "example": "test_api_user"
                            },
                            "addressList": {
                              "type": "string",
                              "description": "Alias of the called address list",
                              "example": "group1@maillist.sendcloud.org"
                            },
                            "memberCount": {
                              "type": "integer",
                              "description": "Number of addresses in the list",
                              "example": 300
                            },
                            "gmtCreated": {
                              "type": "string",
                              "format": "date-time",
                              "description": "Task creation time",
                              "example": "2015-11-26 14:38:09"
                            },
                            "gmtUpdated": {
                              "type": "string",
                              "format": "date-time",
                              "description": "Task modification time",
                              "example": "2015-11-26 14:38:23"
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "Request in",
                                "Request completed"
                              ],
                              "example": "Request completed",
                              "description": "Address list request status. \"Request in\" while the task is still being processed; \"Request completed\" when batch processing has finished. Poll until the terminal value."
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Business error. Note: the server returns HTTP 200 with the business code in `statusCode`; the HTTP status here is a documentation placeholder. See examples for 40019/40020.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "description": "Business error code"
                    },
                    "message": {
                      "type": "string"
                    },
                    "result": {
                      "type": "boolean",
                      "example": false
                    }
                  }
                },
                "examples": {
                  "40020": {
                    "summary": "GLOBAL_MAILLISTTASKID_NOTFOUND — task does not exist, belongs to another account, or was created in another region",
                    "value": {
                      "statusCode": 40020,
                      "message": "maillistTaskId does not exist",
                      "result": false
                    }
                  },
                  "40025": {
                    "summary": "GLOBAL_APIUSER_MANUAL_LOCKED — apiUser manually locked by administrator",
                    "value": {
                      "statusCode": 40025,
                      "message": "This APIUSER is manually locked , please contact the platform administrator",
                      "result": false
                    }
                  },
                  "40026": {
                    "summary": "GLOBAL_APIUSER_AUTO_LOCKED — apiUser automatically locked by domain configuration check",
                    "value": {
                      "statusCode": 40026,
                      "message": "This APIUSER is automatically locked , please check the system domain name configuration",
                      "result": false
                    }
                  },
                  "40019-blank": {
                    "summary": "GLOBAL_MAILLISTTASKID_NOTEMPTY — maillistTaskId missing",
                    "value": {
                      "statusCode": 40019,
                      "message": "maillistTaskId not be blank",
                      "result": false
                    }
                  },
                  "40019-format": {
                    "summary": "GLOBAL_MAILLISTTASKID_ERROR — maillistTaskId non-integer or non-positive",
                    "value": {
                      "statusCode": 40019,
                      "message": "maillistTaskId error",
                      "result": false
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiUser": {
        "type": "apiKey",
        "in": "query",
        "name": "apiUser",
        "description": "API_USER (authentication parameter; obtained from SendCloud console)"
      },
      "apiKey": {
        "type": "apiKey",
        "in": "query",
        "name": "apiKey",
        "description": "API_KEY (authentication parameter; keep confidential)"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```

# Sibling pages

* [X-SMTPAPI](https://docs.aurorasendcloud.com/reference/x-smtpapi.md)
* [Basic Send](https://docs.aurorasendcloud.com/reference/basic-send.md)
* [Send Template Email](https://docs.aurorasendcloud.com/reference/send-email-via-template.md)
* [Send Calendar Email](https://docs.aurorasendcloud.com/reference/send-calendar-email.md)
* [Sandbox Mode](https://docs.aurorasendcloud.com/reference/sandbox-mode.md)