---
title: "Get Batch Progress"
api: "GET /v1/api/batch-calls/{batchId}/status"
description: "Get detailed progress information for a batch call operation"
---

### Headers
<ParamField header="x-workspace-id" type="string" required>
  Workspace identifier for the API.
</ParamField>

### Path Parameters

<ParamField path="batchId" type="string" required>
  The unique identifier of the batch call operation
</ParamField>

### Response

<ResponseField name="status" type="string">
  Current status of the batch operation
</ResponseField>

<ResponseField name="isComplete" type="boolean">
  Whether the batch operation has finished
</ResponseField>

<ResponseField name="waiting" type="number">
  Number of calls waiting in queue
</ResponseField>

<ResponseField name="active" type="number">
  Number of calls currently being processed
</ResponseField>

<ResponseField name="completed" type="number">
  Number of successfully completed calls
</ResponseField>

<ResponseField name="failed" type="number">
  Number of failed calls
</ResponseField>

<ResponseField name="total" type="number">
  Total number of calls in the batch
</ResponseField>

<ResponseField name="startTime" type="number">
  Timestamp when the batch started processing
</ResponseField>

<ResponseField name="lastCompletedTime" type="number">
  Timestamp of the last completed call
</ResponseField>

<ResponseField name="completedTime" type="number">
  Timestamp when the batch was completed (if finished)
</ResponseField>

<ResponseField name="averageCallDuration" type="number">
  Average duration of completed calls in seconds
</ResponseField>

<ResponseField name="recent_calls" type="array">
  Array of recent call results for monitoring
</ResponseField>

### Example Usage

```bash
curl -X GET "https://api.trillet.ai/v1/api/batch-calls/batch_7891011121314/status" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-workspace-id: YOUR_WORKSPACE_ID"
```

### Example Response

```json
{
  "status": "processing",
  "isComplete": false,
  "waiting": 45,
  "active": 5,
  "completed": 95,
  "failed": 5,
  "total": 150,
  "startTime": 1703097600000,
  "lastCompletedTime": 1703101200000,
  "completedTime": null,
  "averageCallDuration": 45.2,
  "recent_calls": [
    {
      "jobId": "call_123",
      "status": "completed",
      "phone_number": "+1234567890",
      "completedAt": 1703101200000,
      "duration": 42
    },
    {
      "jobId": "call_124", 
      "status": "failed",
      "phone_number": "+1987654321",
      "failedAt": 1703101150000,
      "error": "Number busy"
    }
  ]
}
```

### Error Responses

<ResponseField name="error" type="string">
  Error message describing what went wrong
</ResponseField>

**Common Error Codes:**
- `500` - Server error retrieving batch progress information

### Progress Tracking

This endpoint provides real-time progress updates for your batch call operations. Use it to build dashboards or monitor batch completion in your applications.