列出批次

cURL

curl --request GET 'https://api.brightalk.ai/batches?limit=20' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16"

const response = await fetch("https://api.brightalk.ai/batches?limit=20", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
  },
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "GET",
    "https://api.brightalk.ai/batches?limit=20",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "data": [
    {
      "id": "bat_demo_001",
      "name": "Renewal reminders",
      "agent_id": "agt_demo_001",
      "total_recipients": 2,
      "pending_recipients": 2,
      "queued_recipients": 0,
      "in_progress_recipients": 0,
      "completed_recipients": 0,
      "failed_recipients": 0,
      "cancelled_recipients": 0,
      "answered_recipients": 0,
      "no_answer_recipients": 0,
      "busy_recipients": 0,
      "created_at": "2026-07-20T01:00:00Z",
      "updated_at": "2026-07-20T01:00:00Z",
      "scheduled_start_at": "2026-07-20T01:00:00Z",
      "calling_window": {
        "time_zone": "Asia/Taipei",
        "weekdays": [
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday"
        ],
        "start_time": "09:00",
        "end_time": "18:00"
      },
      "started_at": "2026-07-20T01:00:00Z",
      "paused_at": "2026-07-20T01:00:00Z",
      "completed_at": "2026-07-20T01:00:00Z",
      "cancelled_at": "2026-07-20T01:00:00Z"
    }
  ],
  "next_cursor": "<string>"
}

GET

batches

cURL

curl --request GET 'https://api.brightalk.ai/batches?limit=20' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16"

const response = await fetch("https://api.brightalk.ai/batches?limit=20", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
  },
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "GET",
    "https://api.brightalk.ai/batches?limit=20",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "data": [
    {
      "id": "bat_demo_001",
      "name": "Renewal reminders",
      "agent_id": "agt_demo_001",
      "total_recipients": 2,
      "pending_recipients": 2,
      "queued_recipients": 0,
      "in_progress_recipients": 0,
      "completed_recipients": 0,
      "failed_recipients": 0,
      "cancelled_recipients": 0,
      "answered_recipients": 0,
      "no_answer_recipients": 0,
      "busy_recipients": 0,
      "created_at": "2026-07-20T01:00:00Z",
      "updated_at": "2026-07-20T01:00:00Z",
      "scheduled_start_at": "2026-07-20T01:00:00Z",
      "calling_window": {
        "time_zone": "Asia/Taipei",
        "weekdays": [
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday"
        ],
        "start_time": "09:00",
        "end_time": "18:00"
      },
      "started_at": "2026-07-20T01:00:00Z",
      "paused_at": "2026-07-20T01:00:00Z",
      "completed_at": "2026-07-20T01:00:00Z",
      "cancelled_at": "2026-07-20T01:00:00Z"
    }
  ],
  "next_cursor": "<string>"
}

授權

Authorization

string

header

必填

Use a private-beta server credential in the Authorization header.

標頭

Brightalk-Version

string

預設值:2026-07-16

選擇以日期為基礎的 API 版本。省略時會使用組織鎖定的私人測試版預設值。

Allowed value: "2026-07-16"

X-Request-Id

string

由呼叫端產生且符合 [A-Za-z0-9._:-]{1,64} 的關聯值。無效值會被取代。

Maximum string length: 64

Pattern: ^[A-Za-z0-9._:-]{1,64}$

查詢參數

limit

integer

預設值:20

要傳回的資源數量。預設為 20，上限為 100。

必填範圍: 1 <= x <= 100

cursor

string

前一頁傳回的不透明游標。

Required string length: 1 - 2048

status

enum<string>

可用選項:

draft,

scheduled,

queued,

in_progress,

paused,

completed,

failed,

cancelled

created_after

string<date-time>

created_before

string<date-time>

回應

已傳回批次。

data

object[]

必填

Show child attributes

next_cursor

string | null

必填

取消通話建立批次草稿

⌘I

開始使用

API 基礎

核心概念

操作指南

發布資訊

API 參考

授權

標頭

查詢參數

回應