Endpoint
Parameters
Success response 200
Notes
- Use this endpoint to poll every
2s - Stop polling when
statusbecomesdone,failed, orcancelled
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Return the current progress and partial summary for an asynchronous bulk contact job.
GET /api/v1/contacts/bulk-jobs/{jobId}/progress
| Field | Type | Required | Location | Description |
|---|---|---|---|---|
jobId | UUID | yes | path | ID of the bulk job |
200{
"data": {
"id": "job_abc123",
"operation": "add_to_group",
"status": "processing",
"requestedCount": 4900,
"processedCount": 2300,
"progress": 47,
"groupId": "uuid-group",
"summary": {
"added": 2190,
"alreadyInGroup": 80,
"notFound": 30
},
"error": null,
"createdAt": "2026-05-08T10:00:00.000Z",
"updatedAt": "2026-05-08T10:00:08.000Z",
"completedAt": null
}
}
2sstatus becomes done, failed, or cancelled