（邮箱验证）批量任务创建

POST

/api/email/verify

Last modified:2026-07-16 17:19:23

批量上传邮箱，创建邮箱验证任务。

Request

Header Params

Body Params application/json

Example

{
  "type": "bulk_create",
  "emails": [
    "a@example.com",
    "b@example.com"
  ],
  "task_name": "postman batch"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.trade-wind.co/api/email/verify' \
--header 'Authorization: Bearer tw_live_9d991654520ba5bb1b100db5d0d0f62193b887436cb20e4a35b217312ed18626' \
--header 'Content-Type: application/json' \
--data-raw '{
  "type": "bulk_create",
  "emails": [
    "a@example.com",
    "b@example.com"
  ],
  "task_name": "postman batch"
}'

Responses

🟢201成功

application/json

Bodyapplication/json

Example

{
  "success": true,
  "request_id": "req_LSOanvBN53c",
  "type": "bulk_create",
  "task_id": "cmnzwtsjc00bs14dgb52nwllo",
  "reoon_task_id": "5465181",
  "status": "pending",
  "meta": {
    "billing": {
      "credits_charged": 0,
      "byok_used": false,
      "note": "Credits charged when bulk completes (0.1 per email)."
    }
  }
}

🟠400请求有误

🟠401未认证

🟠402需要付款

🟠403权限不足

🟠409冲突

🟠429请求过多

Modified at 2026-07-16 17:19:23

（邮箱验证）单一邮箱查询

（邮箱验证）批量任务结果查询