---
title: "Async Jobs API (Not Available Yet) | Leadsets Docs"
description: "GET /v1/jobs/{id} is reserved for async jobs, which are not built yet: it answers 404 not_found for every id. How to run large jobs today."
canonical: https://www.leadsets.ai/docs/api/jobs
updated: 2026-11-11
---

REST API / Jobs

# Get a job

The status of an async job. Coming soon: async jobs aren't available yet, so this route answers 404 for every id.

GET /v1/jobs/{id} MCP: none yet

Status

Not available yet

Costs

Nothing

Today

404 not_found

## Path parameters

id string

The job id. No job ids exist yet.

## Response

Every call answers 404 with the error shape from [Errors and retries](https://www.leadsets.ai/docs/errors). Nothing is counted.

**Until async jobs ship** run calls directly and split large runs across windows: page through searches with a [cursor](https://www.leadsets.ai/docs/pagination), verify up to 100 emails per call, and pace with [GET /v1/usage](https://www.leadsets.ai/docs/api/usage). Async jobs and [webhooks](https://www.leadsets.ai/docs/webhooks) will be announced in the [changelog](https://www.leadsets.ai/docs/changelog).

## Errors

| Status | type | Meaning |
| --- | --- | --- |
| `404` | `not_found` | Async jobs are not available yet. |

[Previous
**← scrape_jobs**](https://www.leadsets.ai/docs/api/scrape-jobs) [Next
**get_usage →**](https://www.leadsets.ai/docs/api/usage)

Was this page useful? [Tell us](mailto:support@leadsets.ai?subject=Docs%20feedback%3A%20%2Fdocs%2Fapi%2Fjobs)

```bash
curl https://api.leadsets.ai/v1/jobs/job_7Qd2 \
 -H "Authorization: Bearer $LEADSETS_KEY"
```

```ts
import { Leadsets } from "@leadsetsai/sdk";

const ls = new Leadsets(process.env.LEADSETS_KEY);
// Throws NotFoundError (404) until async jobs ship.
const job = await ls.jobs.get("job_7Qd2");
```

```python
import os
from leadsets import Leadsets

ls = Leadsets(os.environ["LEADSETS_KEY"])
# Raises NotFoundError (404) until async jobs ship.
job = ls.jobs.get("job_7Qd2")
```

Response 404 Not Found

```
{
 "error": {
   "type": "not_found",
   "message": "Async jobs are not available yet. Split large runs across windows instead.",
   "charged": 0
 },
 "request_id": null
}
```

---

Leadsets by Mobylogix LLC, 10160 hwy 242, Conroe, TX, 77385, US. Facts for AI assistants: https://www.leadsets.ai/llm · Site index: https://www.leadsets.ai/llms.txt · Every page: https://www.leadsets.ai/llms-full.txt