Skip to main content

​
GET /api/v1/bd/jobs/{job_id}

Fetch the current status and progress of a BD job. Poll this endpoint until status is "completed", "failed", or "cancelled".

​
Path parameters

​
job_id
string
required
UUID of the BD job from POST /api/v1/bd/jobs.

​
Response

​
job_id
string
UUID of the job.
​
status
string
Current status: "pending", "running", "completed", "failed", or "cancelled".
​
progress_percent
integer
Completion percentage (0–100).
​
progress_message
string
Human-readable description of the current stage.
​
preset
string
The preset used for this job.
​
requested_capabilities
array
Capabilities resolved at planning time.
​
warnings
array
Non-fatal warnings raised during execution.
​
error_message
string
Set when status is "failed". Describes what went wrong.
​
created_at
string
ISO 8601 timestamp when the job was created.
​
updated_at
string
ISO 8601 timestamp of the last status update.
​
started_at
string
ISO 8601 timestamp when the job began executing. null when still pending.
​
completed_at
string
ISO 8601 timestamp when the job finished. null while running.

​
Example

cURL
curl https://api.deepcurrent.app/api/v1/bd/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer $TOKEN"
Response (running)
{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "running",
  "progress_percent": 62,
  "progress_message": "Discovering contacts at 2 companies...",
  "preset": "full_pipeline",
  "requested_capabilities": [
    "qualification",
    "contact_discovery",
    "email_lookup",
    "email_verify",
    "deliverable_finalize"
  ],
  "warnings": [],
  "error_message": null,
  "created_at": "2026-04-08T12:00:00Z",
  "updated_at": "2026-04-08T12:04:30Z",
  "started_at": "2026-04-08T12:00:05Z",
  "completed_at": null
}
Response (completed)
{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "progress_percent": 100,
  "progress_message": "Job complete.",
  "preset": "full_pipeline",
  "requested_capabilities": [
    "qualification",
    "contact_discovery",
    "email_lookup",
    "email_verify",
    "deliverable_finalize"
  ],
  "warnings": [],
  "error_message": null,
  "created_at": "2026-04-08T12:00:00Z",
  "updated_at": "2026-04-08T12:08:12Z",
  "started_at": "2026-04-08T12:00:05Z",
  "completed_at": "2026-04-08T12:08:12Z"
}