Skip to main content

​
GET /api/v1/growth/runs/{run_id}

Retrieve the current status, progress, and result handles for a growth run. Poll this endpoint until status is "completed" or "failed".
Requires an active paid subscription.

​
Path parameters

​
run_id
string
required
UUID of the growth run returned by POST /api/v1/growth/run.

​
Response

​
run_id
string
UUID of the run.
​
status
string
Current status: "pending", "running", "completed", "failed", or "cancelled".
​
stage_status
object
Per-stage progress breakdown (e.g. { "email_lookup": "completed", "email_verify": "running" }).
​
progress
object
Progress details including percent and message.
​
result_handles
array
Available result records when status is "completed".
​
artifact_handles
array
Downloadable output artifacts when status is "completed".
​
export_handles
array
Export-ready file handles (CSV, JSON) when available.
​
preview
object
Summary of delivered counts, pricing, and rebate credits.
​
data_source_mix
object
Breakdown of how many records were enriched and from which pipeline stages.
​
gap_report
object
Records that could not be enriched or verified.

​
Example

cURL
curl https://api.deepcurrent.app/api/v1/growth/runs/7c3e1d22-9b4a-4f8c-b1e2-3d5f0a7c9e1b \
  -H "Authorization: Bearer $TOKEN"
Response (running)
{
  "run_id": "7c3e1d22-9b4a-4f8c-b1e2-3d5f0a7c9e1b",
  "status": "running",
  "stage_status": { "email_lookup": "running" },
  "progress": { "percent": 45, "message": "Discovering email addresses..." },
  "result_handles": [],
  "artifact_handles": [],
  "export_handles": [],
  "preview": {},
  "data_source_mix": {},
  "gap_report": {}
}
Response (completed)
{
  "run_id": "7c3e1d22-9b4a-4f8c-b1e2-3d5f0a7c9e1b",
  "status": "completed",
  "stage_status": {
    "email_lookup": "completed",
    "email_verify": "completed"
  },
  "progress": { "percent": 100, "message": "Run complete." },
  "result_handles": [],
  "artifact_handles": [
    { "asset_id": "verified_contacts", "label": "Verified Contacts", "kind": "contacts" }
  ],
  "export_handles": [],
  "preview": {
    "delivered_counts": { "delivered_contacts": 95, "verified_emails": 78 },
    "pricing": { "rebate_credits": 20 }
  },
  "data_source_mix": { "enriched": 95 },
  "gap_report": { "unresolved": 5 }
}