Skip to main content
Hosted growth is DeepCurrent’s automated outreach orchestration. You describe what you want to achieve — find leads, enrich a company list, verify emails — and DeepCurrent handles enrichment, sequencing, and result delivery. Credits are charged transparently against your balance, and you always see the cost before execution begins.

The four-step flow

Every growth run follows the same sequence: resolve your goal into a structured plan, get a credit quote, confirm and execute, then poll for results.
1

Resolve — describe your goal

Send a plain-text description of what you want to accomplish. DeepCurrent parses your intent and returns a structured goal_plan that specifies the target audience, channels, volume, and enrichment capabilities needed.
POST /api/v1/growth/resolve
Authorization: Bearer <your-api-key>
Content-Type: application/json
{
  "goal_text": "Find decision-makers at DeFi protocols on Ethereum and get their work emails",
  "constraints": {
    "count": 50,
    "niche": "DeFi"
  }
}
Response
{
  "goal_type": "contact_enrichment",
  "coverage_mode": "partial",
  "quotable": true,
  "suggested_next_action": "Call /growth/quote with the goal_plan below.",
  "goal_plan": {
    "pipeline_id": "...",
    "preset": "full_pipeline",
    "input_assets": { "companies": [] },
    "output": { "preview_rows": 10 }
  }
}
The goal_plan object is the canonical input to all subsequent steps. Pass it unchanged.
2

Quote — get the credit estimate

Submit the goal_plan to get a credit cost estimate and a quote_token. No credits are deducted at this step.
POST /api/v1/growth/quote
Authorization: Bearer <your-api-key>
Content-Type: application/json
{
  "goal_plan": { ... }
}
Response
{
  "ok": true,
  "quotable": true,
  "credits_total": 450,
  "quote_token": "eyJ...",
  "expiry": "2026-04-08T12:30:00Z",
  "cost_breakdown": {
    "enrichment": 450
  },
  "suggested_next_action": "Confirm this quote to start the growth run."
}
The quote token expires after a short window. If you do not run within that window, request a fresh quote.
You can pass max_external_spend_credits to cap how many credits the provider enrichment step may use. If the estimated cost exceeds your cap, the quote returns quotable: false with an error_code of max_external_spend_too_low.
3

Run — execute the plan

Submit the quote_token and goal_plan to start execution. Credits are deducted at this step. The response returns a run_id you use to check progress.
POST /api/v1/growth/run
Authorization: Bearer <your-api-key>
Content-Type: application/json
{
  "quote_token": "eyJ...",
  "goal_plan": { ... }
}
Response (202 Accepted)
{
  "status": "running",
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "preview": {
    "message": "Enrichment has been queued.",
    "pipeline_id": "full_pipeline"
  }
}
Quote tokens are single-use. Submitting the same token twice returns a 403 error.
4

Status — poll for results

Poll the status endpoint with your run_id until the status reaches a terminal state (completed, failed, or cancelled).
GET /api/v1/growth/runs/{run_id}
Authorization: Bearer <your-api-key>
Response (in progress)
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "running",
  "progress": {
    "percent": 42,
    "message": "Enriching contacts..."
  }
}
Response (completed)
{
  "run_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "result_handles": [ ... ],
  "export_handles": [ ... ]
}
When the run completes, the enriched contacts and records appear in Downloads in the dashboard. You can also access them via the export_handles in the status response.

What the goal plan contains

The goal_plan returned by /resolve is a structured object that specifies:
  • Target audience — the ICP or company list to enrich
  • Provider preset — the enrichment pipeline (e.g., full_pipeline, enrich_contacts_from_companies, verify_existing_emails)
  • Input assets — companies or contacts you supply as starting points
  • Output settings — preview row count and requested capabilities
You do not need to construct or modify goal_plan manually. The resolve step builds it from your goal text and the chat interface carries it forward automatically.

Credit model

Growth runs are quoted upfront. There are no metered surprises:
  1. The quote step calculates the total cost based on the provider preset, audience size, and requested enrichment depth.
  2. You confirm the cost by submitting the quote_token.
  3. Credits are deducted exactly once at run time, for the quoted amount.
The chat interface shows the credit cost as a confirmation card before execution. You can approve or cancel at that point.

When to use growth vs intelligence

Use caseRecommended path
Curated shortlist from DeepCurrent’s databaseIntelligence packages
Enrich a company or contact list you already haveGrowth flow
Full pipeline — discover + enrich + verify emailsGrowth flow
Verify or clean an existing email listGrowth flow