メインコンテンツへスキップ
GET
Get Call Batch

承認

Authorization
string
header
必須

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

ヘッダー

Cartesia-Version
enum<string>
デフォルト:2026-03-01
必須

API version header.

利用可能なオプション:
2026-03-01
:

"2026-03-01"

パスパラメータ

batch_id
string
必須

The ID of the batch.

レスポンス

The batch, including its recipients.

id
string
必須

The unique identifier for the batch.

name
string
必須

The batch's label.

agent_id
string
必須

The identifier of the agent that handles the batch's calls.

from_number_id
string
必須

The identifier of the phone number the batch dials from.

region
enum<string>
必須

The deployment region whose dispatcher drains the batch.

利用可能なオプション:
US,
EU,
APAC
target_concurrency_limit
integer
必須

Maximum number of calls from this batch dialed concurrently.

status
enum<string>
必須

The batch's lifecycle status, derived at read time from dispatch progress.

StatusMeaning
pendingNo calls dispatched yet
in_progressSome calls dispatched, not all
completedAll recipients dispatched
failedAll recipients failed before dialing
cancelledCancelled before every call was dispatched
利用可能なオプション:
pending,
in_progress,
completed,
failed,
cancelled
total_calls_scheduled
integer
必須

Total recipients queued in the batch.

total_calls_dispatched
integer
必須

Recipients handed to the dialer so far, including those that failed before a call could be placed.

total_calls_finished
integer
必須

Recipients whose latest call attempt reached a terminal state (completed or failed), including pre-dial failures.

retry_count
integer
必須

Number of times the batch has been retried. 0 until the first retry.

created_at
string<date-time>
必須

When the batch was created.

last_updated_at
string<date-time>
必須

When the batch was last updated.

scheduled_at
string<date-time>

The scheduled dispatch time, in RFC3339 UTC format. Omitted for batches that dispatch immediately.

admitted_at
string<date-time>

The actual dispatch time, in RFC3339 UTC format. The batch may stay unadmitted in the queue due to scheduling or unavailable concurrency.

recipients
AgentCallBatchRecipient · object[]

The batch's recipients. Returned only on GET /agents/calls/batches/{batch_id}.