Skip to main content

​
POST /api/v1/intelligence/resolve

Parse a free-text request into the structured slots required by the given intelligence package. The response tells you which slots are filled, which are still missing, and whether DeepCurrent’s curated corpus has enough coverage to proceed. Use this endpoint to drive a conversational slot-filling flow before calling /quote.

​
Package IDs

Package IDName
vc-shortlist-v1Curated VC Shortlist
builder-discovery-v1Active Builder Discovery
company-people-discovery-v1Company People Discovery
warm-intro-paths-v1Target Fund Intro Paths
kol-discovery-v1KOL Discovery
user-prospect-v1User/Community Prospect Discovery
hackathon-builder-v1Hackathon Builder Discovery

​
Request body

​
package_id
string
required
ID of the intelligence package to resolve against. See the table above.
​
slots
object
Key-value pairs of already-known slot values. Omit or pass {} to let request_text do the work.
​
request_text
string
Free-text description of what you’re looking for. The service extracts slot values automatically.

​
Response

​
intent_status
string
"needs_clarification" when required slots are still missing; "ready_for_quote" when all required slots are filled.
​
package_id
string
The resolved package ID.
​
package_name
string
Human-readable package name.
​
missing_slots
array
List of required slot names that are not yet filled.
​
clarification_questions
array
Suggested questions to ask the user to fill missing slots.
​
filled_slots
object
All slot values resolved so far, including those extracted from request_text.
​
coverage
object
Corpus coverage signal. null when no preview is available.

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/intelligence/resolve \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "vc-shortlist-v1",
    "request_text": "I need DeFi seed-stage VCs for my protocol"
  }'
Response
{
  "intent_status": "ready_for_quote",
  "package_id": "vc-shortlist-v1",
  "package_name": "Curated VC Shortlist",
  "missing_slots": [],
  "clarification_questions": [],
  "filled_slots": {
    "sector_focus": "DeFi",
    "stage": "seed",
    "limit": 10
  },
  "coverage": {
    "status": "sufficient",
    "candidate_count": 42,
    "note": null,
    "fallback_allowed": false,
    "alternative_route": null
  }
}