Skip to main content
GET
/
api
/
v1
/
batch
/
check-status
Get Batch Statistics (Overall Progress)
curl --request GET \
  --url https://sa.dialgen.ai/api/v1/batch/check-status \
  --header 'Authorization: Bearer <token>'
{
  "batchId": "batch_1767385567962_...",
  "status": "completed",
  "priority": 5,
  "statistics": {
    "total": 1,
    "processed": 1,
    "succeeded": 1,
    "failed": 0,
    "pending": 0,
    "percentComplete": 100,
    "successRate": 100
  },
  "performance": {
    "callsPerSecond": 0.01,
    "estimatedTimeRemaining": null,
    "elapsedTime": 72
  },
  "timestamps": {
    "createdAt": "2026-01-02T20:27:34.060Z",
    "startedAt": "2026-01-02T20:27:34.059Z",
    "completedAt": "2026-01-02T20:28:46.214Z"
  },
  "recentCalls": [
    {
      "id": "cmjxbsai4001...",
      "callSid": "CA123...",
      "status": "COMPLETED",
      "duration": 46,
      "createdAt": "2026-01-02T20:27:34.060Z",
      "phoneNumber": "+1234567890",
      "contactName": "John Doe"
    }
  ],
  "webhooks": null,
  "agentId": "cmghxkg2p...",
  "userId": "user_33m..."
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain your API key from the Dialgen API Keys dashboard at https://sa.dialgen.ai/api-keys

Query Parameters

​
batchId
string
required

The ID returned from POST /api/v1/batch

Example:

"batch_1678886400_agent_clx123..."

​
limit
string
default:10

Number of recent calls to return. Defaults to 10. Use 'all' or '-1' to return all calls in the batch.

Example:

"20"

Response

Batch statistics retrieved successfully

​
batchId
string
​
status
enum<string>
Available options:
ingesting,
scheduled,
pending,
processing,
completed,
cancelled
​
priority
number
​
statistics
object
​
performance
object
​
timestamps
object
​
recentCalls
object[]
​
webhooks
object
​
agentId
string
​
userId
string