Skip to main content

​
POST /api/v1/growth/resolve

Parse a natural-language goal description and any input assets (contacts or companies) into a normalised goal_plan. The response tells you whether the plan is ready to quote and what input requirements are still missing. Pass the returned goal_plan directly to POST /api/v1/growth/quote.

​
Request body

​
goal_text
string
required
Free-text description of the growth goal. Minimum 3 characters, maximum 2000. Example: "Find emails for 200 DeFi founders and verify deliverability"
​
constraints
object
Optional constraints to narrow the plan.
​
input_assets
object
Pre-existing contact or company records to enrich or qualify.
​
input_text
string
Pasted plain-text rows (e.g. CSV content or a list of domains). Maximum 50000 characters.
​
icp_config
object
Optional ICP (Ideal Customer Profile) configuration used for qualification gating.

​
Response

​
goal_type
string
Classified goal type (e.g. "email_discovery", "contact_enrichment").
​
coverage_mode
string
Indicates how well the goal can be fulfilled from DeepCurrent’s data: "sufficient", "partial", or "needs_enrichment".
​
recommended_path
string
The recommended execution strategy for this plan, e.g. "enrichment_only" or "enrichment_plus_fallback".
​
quotable
boolean
true when the plan can be passed to /growth/quote without changes.
​
missing_requirements
array
List of missing input requirements that must be supplied before the plan is quotable.
​
suggested_next_action
string
Human-readable instruction for the next step.
​
goal_plan
object
Structured plan object. Pass this to POST /api/v1/growth/quote.
​
normalized_input_assets
object
Input assets after canonical field normalization.

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/growth/resolve \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "goal_text": "Find and verify emails for 100 DeFi protocol founders",
    "constraints": { "niche": "DeFi", "count": 100 }
  }'
Response
{
  "goal_type": "email_discovery",
  "coverage_mode": "partial",
  "recommended_path": "enrichment_plus_fallback",
  "quotable": true,
  "missing_requirements": [],
  "suggested_next_action": "Confirm this goal plan to get a credit quote.",
  "goal_plan": {
    "pipeline_id": "email_discovery_v1",
    "preset": "full_pipeline",
    "output": { "required_fields": ["email"], "preview_rows": 10 }
  },
  "normalized_input_assets": { "companies": [], "contacts": [] },
  "fallback_capabilities": ["email_lookup", "email_verify"]
}