Skip to main content

​
POST /api/v1/intelligence/execute

Execute an intelligence package query using a valid quote token. Returns a result_id that you use to fetch the full record set from GET /api/v1/intelligence/results/{result_id}. Credits are deducted from your balance after execution. If an identical query was previously executed for your account, the existing result is returned at zero cost.
Requires an active paid subscription. Free and developer-tier accounts will receive 403 Forbidden.

​
Request body

​
package_id
string
required
ID of the intelligence package to execute.
​
slots
object
required
Filled slot values. Must match the slots used when the quote was generated.
​
output_fields
array
required
Tier 1 output field names to include. Must match output_fields from the quote.
​
quote_token
string
required
Single-use token from POST /api/v1/intelligence/quote. Consumed on success.

​
Response

​
result_id
string
UUID of the newly created (or reused) IntelligenceResult. Use this to fetch full records.
​
summary
string
One-sentence rationale summary generated for the result set.
​
records_count
integer
Number of Tier 1 records returned.

​
Fetching the full result

After executing, retrieve the records with: 
GET /api/v1/intelligence/results/{result_id}
That endpoint returns the full records array along with available_expansions — the Tier 2 options you can unlock from this result.

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/intelligence/execute \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "package_id": "vc-shortlist-v1",
    "slots": {
      "sector_focus": "DeFi",
      "stage": "seed",
      "limit": 10
    },
    "output_fields": ["name", "website", "focus_area", "tier", "rationale"],
    "quote_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }'
Response
{
  "result_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "summary": "10 seed-stage DeFi VCs ranked by co-investor signals and recent deal activity.",
  "records_count": 10
}

​
Retrieving records

cURL
curl https://api.deepcurrent.app/api/v1/intelligence/results/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer $TOKEN"
Response
{
  "result_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "package_id": "vc-shortlist-v1",
  "summary": "10 seed-stage DeFi VCs ranked by co-investor signals and recent deal activity.",
  "records_count": 10,
  "records": [
    {
      "name": "Paradigm",
      "website": "https://paradigm.xyz",
      "focus_area": "DeFi, Infrastructure",
      "tier": "Tier 1",
      "rationale": "Lead investor in multiple seed-stage DeFi protocols with a strong DeFi thesis."
    }
  ],
  "available_expansions": [
    {
      "type": "contact_unlock",
      "label": "Unlock contact details (choose tier)",
      "description": "Unlock contact details for a selected subset. Tiers: social, email, telegram, phone.",
      "estimated_credits": 500
    },
    {
      "type": "increase_limit",
      "label": "Increase discovery limit",
      "description": "Get more Tier 1 curated records with the same filters and rationale.",
      "estimated_credits": 60
    }
  ],
  "created_at": "2026-04-08T12:00:00Z"
}