Get Job

GET/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).

Path parameters

idstringrequired
Job id (the id of a started job or of the resource it created).

Responses

200 The job.
400 Malformed id (VALIDATION_ERROR, invalid_format).
401 Missing, unknown or inactive credentials (UNAUTHORIZED).
404 No job with this id in the workspace (NOT_FOUND).
429 Over the poll rate limit (RATE_LIMIT); wait Retry-After seconds. Sent only where rate limits are enforced for the caller channel.
500 Unexpected server error.

For error handling see Errors. Response objects are described in Person object and Company object.

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

Response

{
  "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"
  }
}