Skip to main content

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

Fetch the output assets and summary for a BD job. This endpoint is available at any job status — check status before accessing assets. Result assets are downloaded individually via GET /api/v1/bd/jobs/{job_id}/assets/{asset_id}.

​
Path parameters

​
job_id
string
required
UUID of the BD job.

​
Response

​
result_id
string
UUID of the result record. null while the job has not yet produced a result.
​
job_id
string
UUID of the parent job.
​
status
string
Current job status: "pending", "running", "completed", "failed", or "cancelled".
​
progress_percent
integer
Completion percentage (0–100).
​
progress_message
string
Human-readable current stage description.
​
summary
object
Aggregated delivery summary (e.g. { "delivered_contacts": 18, "verified_emails": 14 }).
​
warnings
array
Non-fatal warnings from execution.
​
result_assets
array
List of downloadable output assets.
​
created_at
string
ISO 8601 timestamp of the result record.
​
completed_at
string
ISO 8601 timestamp when the job completed. null while running.

​
Example

cURL
curl https://api.deepcurrent.app/api/v1/bd/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/result \
  -H "Authorization: Bearer $TOKEN"
Response
{
  "result_id": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "progress_percent": 100,
  "progress_message": "Job complete.",
  "summary": {
    "delivered_contacts": 18,
    "verified_emails": 14,
    "companies_processed": 2
  },
  "warnings": [],
  "result_assets": [
    {
      "asset_id": "verified_contacts",
      "label": "Verified Contacts",
      "kind": "contacts",
      "mime_type": "application/json",
      "availability": "inline",
      "download_url": "/api/v1/bd/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/assets/verified_contacts"
    }
  ],
  "created_at": "2026-04-08T12:08:12Z",
  "completed_at": "2026-04-08T12:08:12Z"
}

​
Downloading an asset

cURL
curl https://api.deepcurrent.app/api/v1/bd/jobs/a1b2c3d4-e5f6-7890-abcd-ef1234567890/assets/verified_contacts \
  -H "Authorization: Bearer $TOKEN"