Lists
v1
Get Batch Add to List Job
Retrieve the status of a batch add-to-list job created via POST /v1/lists/batch-add-to-list-jobs.
While status is running, results and summary are omitted. Once status becomes completed, results carries the per-item outcome and summary carries the per-outcome counts (including failed_count) together with list_size_before and list_size_after. On failed, errors describes the failure.
Credit Note: This endpoint does not consume credits.
:::info Requires the lists:read OAuth2 scope. :::
get/v1/lists/batch-add-to-list-jobs/{job_id}
Path parameters
job_idstring required
The unique identifier of the batch add-to-list job.
Query parameters
account_idstring required
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
Response
Batch add-to-list job status retrieved
Example response
{
"data": {
"type": "batch_add_to_list_job",
"id": "job_550e8400-e29b-41d4-a716-446655440000",
"attributes": {
"status": "running",
"configuration": {
"list_id": "company_123",
"items": [
{
"type": "company",
"id": "159001425"
}
]
},
"results": [
{
"id": "159001425",
"type": "company",
"status": "added"
}
],
"summary": {
"added": 2,
"list_size_before": 51,
"list_size_after": 53
},
"errors": [
{
"code": "job_failed",
"title": "External contact data provider timeout"
}
],
"created_at": "2026-05-13T12:00:00Z",
"completed_at": "2026-05-13T12:00:18Z"
}
},
"meta": {
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}