> ## Documentation Index
> Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get list import progress

> Follow the background import of an uploaded contact list

# Get list import progress

Returns the import status of a contact list uploaded with [Upload contact list](https://docs.talkover.ai/api-reference/endpoints/upload-campaign-list). Poll it every few seconds until `status` is `completed` or `failed`.

## Endpoint

```
GET /api/v1/campaigns/{campaign_id}/files/{file_data_id}/progress
```

## Path parameters

**campaign\_id** `string` *required*

Campaign UUID.

**file\_data\_id** `string` *required*

The `file_data_id` returned by the upload.

## Request headers

**Authorization** `string` *required*

Bearer token. Format: `Bearer talq_your_environment_token_here`

## Examples

```bash theme={null}
curl "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/files/list-uuid/progress" \
  -H "Authorization: Bearer talq_your_environment_token_here"
```

## Response

```json theme={null}
{
  "success": true,
  "data": {
    "status": "processing",
    "progress": {
      "rows_processed": 10000,
      "total_records": 18342,
      "imported": 9820,
      "failed": 12,
      "duplicates": 168
    }
  }
}
```

**status** `string`

`processing`, `completed` or `failed`.

**progress** `object | null`

Counters updated every 500 rows while the import runs. `null` before the first 500 rows and after the import ends.

## Error responses

### 404 — Not found

The campaign does not exist, belongs to another environment, or the list belongs to another campaign.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.