Skip to main content

​
POST /api/v1/intelligence/expand

Expand an existing Tier 1 intelligence result by unlocking contact details, adding network depth, or fetching more records. All expansions require a valid quote token from POST /api/v1/intelligence/quote with expansion_scope set. You are never charged twice for the same contact unlock. If an entity has already been unlocked at the requested tier, it is returned at zero cost.
Requires an active paid subscription.

​
Expansion types

TypeDescription
contact_unlockUnlock X/LinkedIn/GitHub (social), email, Telegram, or phone for selected records
increase_limitFetch additional Tier 1 records using the same slots and rationale
network_depthAdd co-investor paths and relationship context (available on select packages)

​
Contact tiers (unlock ladder)

Each tier is cumulative — purchasing email also includes social.
TierUnlocksCredits per contact (approx.)
socialX, LinkedIn, GitHub50
emailemail + social100
telegramTelegram + email + social300
phonePhone + telegram + email + social600

​
Request body

​
parent_result_id
string
required
UUID of the Tier 1 IntelligenceResult to expand.
​
expansion_type
string
required
One of contact_unlock, increase_limit, or network_depth.
​
expansion_params
object
required
Parameters for the expansion. Shape depends on expansion_type.
​
quote_token
string
required
Single-use token from POST /api/v1/intelligence/quote with expansion_scope. Consumed on success.

​
Response

​
result_id
string
UUID of the new expansion IntelligenceResult.
​
parent_result_id
string
UUID of the Tier 1 result this expansion was derived from.
​
expansion_type
string
The expansion type that was applied.
​
records
array
Expanded records. For contact_unlock, these are the originally selected records with contact fields populated. For increase_limit, these are the additional records.
​
records_count
integer
Number of records in this expansion result.
​
credits_charged
integer
Credits actually deducted (may be less than the quoted amount if some contacts were already unlocked).

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/intelligence/expand \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "parent_result_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "expansion_type": "contact_unlock",
    "expansion_params": {
      "selection": { "mode": "top_n", "n": 5 },
      "contact_tier": "email"
    },
    "quote_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }'
Response
{
  "result_id": "9b2e1f44-3c8a-4d12-a7b5-1e9f0d3c5e7a",
  "parent_result_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "expansion_type": "contact_unlock",
  "records_count": 5,
  "credits_charged": 480,
  "records": [
    {
      "name": "Paradigm",
      "website": "https://paradigm.xyz",
      "email": "deals@paradigm.xyz",
      "LinkedIn_URL": "https://linkedin.com/company/paradigm-xyz",
      "X_URL": "https://x.com/paradigm"
    }
  ]
}