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.Resolve — describe your goal
Send a plain-text description of what you want to accomplish. DeepCurrent parses your intent and returns a structured ResponseThe
goal_plan that specifies the target audience, channels, volume, and enrichment capabilities needed.goal_plan object is the canonical input to all subsequent steps. Pass it unchanged.Quote — get the credit estimate
Submit the ResponseThe quote token expires after a short window. If you do not run within that window, request a fresh quote.
goal_plan to get a credit cost estimate and a quote_token. No credits are deducted at this step.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.Run — execute the plan
Submit the Response (202 Accepted)Quote tokens are single-use. Submitting the same token twice returns a
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.403 error.Status — poll for results
Poll the status endpoint with your Response (in progress)Response (completed)When the run completes, the enriched contacts and records appear in Downloads in the dashboard. You can also access them via the
run_id until the status reaches a terminal state (completed, failed, or cancelled).export_handles in the status response.What the goal plan contains
Thegoal_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
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:- The quote step calculates the total cost based on the provider preset, audience size, and requested enrichment depth.
- You confirm the cost by submitting the
quote_token. - Credits are deducted exactly once at run time, for the quoted amount.
When to use growth vs intelligence
| Use case | Recommended path |
|---|---|
| Curated shortlist from DeepCurrent’s database | Intelligence packages |
| Enrich a company or contact list you already have | Growth flow |
| Full pipeline — discover + enrich + verify emails | Growth flow |
| Verify or clean an existing email list | Growth flow |