# Get Job

`GET https://api.getprospect.com/v2/jobs/{id}`

Reads any async job of the workspace by id: an export, a CSV enrichment, an email verification, a bulk action (Trash, list moves and deletes) or a save / enrich run over a search. `Retry-After` is sent while the job is `queued` or `running`; `awaiting_confirmation` waits for you (start or cancel the resource at `resource_url`). Free; a `poll` (0 rate-limit units, per-second window only).

## Authentication

Pass your API key in the `x-api-key` header.

## Path parameters

- `id` (string, required): Job id (the `id` of a started job or of the resource it created).

## Example request

```bash
curl --request GET \
  --url https://api.getprospect.com/v2/jobs/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Response 200

The job.

```json
{
  "success": true,
  "data": {
    "id": "66ff0c1e2a4b5c6d7e8f9012",
    "type": "people_delete",
    "status": "running",
    "total": 25000,
    "processed": 7000,
    "progress_percent": 28,
    "result": {
      "deleted": 6950,
      "skipped": 50
    },
    "error": null,
    "resource_url": null,
    "created_at": "2026-10-05T09:00:00.000Z",
    "finished_at": null
  },
  "metadata": {
    "timestamp": "2026-10-05T09:00:00.000Z"
  }
}
```

## Response 400

Malformed id (`VALIDATION_ERROR`, `invalid_format`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-05T09:00:00.000Z"
  },
  "errors": [
    {
      "name": "VALIDATION_ERROR",
      "message": "\"42\" is not a valid job id.",
      "payload": {
        "code": "invalid_format",
        "field": "id",
        "received_value": "42"
      }
    }
  ]
}
```

## Response 401

Missing, unknown or inactive credentials (`UNAUTHORIZED`).

## Response 404

No job with this id in the workspace (`NOT_FOUND`).

## Response 429

Over the `poll` rate limit (`RATE_LIMIT`); wait `Retry-After` seconds. Sent only where rate limits are enforced for the caller channel.

## Response 500

Unexpected server error.