Bulk uploads

# People found by a bulk task

GET `/api/v1/bulk/tasks/{taskId}/results`

Available when the task is completed, paused or cancelled (partial results).

## Parameters

| Name                           | Type    | Description                                                 |
| ------------------------------ | ------- | ----------------------------------------------------------- |
| `taskId` Required · in path    | string  | —                                                           |
| `page` Optional · in query     | integer | Page number, from 1. Values below 1 count as 1. Default: 1. |
| `per_page` Optional · in query | integer | Items per page. Clamped to 5–100. Default 20. Default: 20.  |

## Responses

- 200 One page of people found

- 401 The API key is missing or unknown

- 403 No active Scale or Enterprise plan bought in the last 30 days

- 404 No task with this id belongs to you

- 422 The task has not finished yet

- 429 More than 1,500 requests with this key in the last hour

```
curl -X GET "https://server.localcontact.ai/api/v1/bulk/tasks/0f8c3a52-7f4e-4c1e-9b8a-2a5d6c1e9f00/results" \
  -H "Authorization: Bearer $LOCALCONTACT_API_KEY"
```

Response · 200

```
{
  "data": [
    {
      "name": "string",
      "title": "string",
      "company_name": "string",
      "company_domain": "string",
      "company_type": "string",
      "company_address": "string"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 1,
    "last_page": 1
  }
}
```

## Error examples

401 · The API key is missing or unknown

```
{
  "error": "API token missing"
}
```

403 · No active Scale or Enterprise plan bought in the last 30 days

```
{
  "error": "API access requires an active Scale or Enterprise plan.",
  "upgrade_url": "https://localcontact.ai/dashboard/billing"
}
```

404 · No task with this id belongs to you

```
{
  "message": "No query results for model [App\\Models\\SearchTask]."
}
```

422 · The task has not finished yet

```
{
  "error": "Results not available yet"
}
```

429 · More than 1,500 requests with this key in the last hour

```
{
  "error": "Rate limit exceeded. Max 100 requests per hour.",
  "retry_after": 3600
}
```

Source: https://localcontact.ai/docs/api/get-bulk-results · Updated: 2026-11-15
