Skip to main content

​
POST /api/v1/intelligence/quote

Generate a quote for a Tier 1 execute or a Tier 2 expansion. The response includes the credit cost and a quote_token you must pass to /execute or /expand. Quote tokens are single-use and expire after a short window. Quoting is available to any authenticated user. A paid entitlement is only enforced at execution time.
If you also need a corpus preview alongside the quote, use POST /api/v1/intelligence/preview-quote instead — it combines resolve and quote in a single call.

​
Request body

​
package_id
string
required
ID of the intelligence package to quote.
​
slots
object
required
Filled slot values for the package. All required slots must be present.
​
output_fields
array
required
List of Tier 1 output field names to include in the result.
​
request_text
string
Optional free-text input used to augment or fill slots automatically.
​
expansion_scope
object
Present when quoting a Tier 2 expansion instead of a Tier 1 execute. Must contain exactly one key: contact_unlock, increase_limit, or network_depth.
​
parent_result_id
string
UUID of the parent IntelligenceResult. Required when expansion_scope is provided.

​
Response

​
package_id
string
The package being quoted.
​
quote_token
string
Single-use JWT. Pass this to /execute or /expand.
​
credits
integer
Credit cost that will be deducted on execution.
​
output_projection_summary
string
Comma-separated list of output fields that will be returned.
​
expiry
string
ISO 8601 timestamp when the quote token expires.
​
filled_slots
object
Normalised slot values used to compute the quote.
​
output_fields
array
Validated list of output fields.
​
context
object
Optional metadata about the quote. Present when the cost is zero or the result already exists.

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/intelligence/quote \
  -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"]
  }'
Response
{
  "package_id": "vc-shortlist-v1",
  "quote_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "credits": 200,
  "output_projection_summary": "name, website, focus_area, tier, rationale",
  "expiry": "2026-04-08T14:35:00Z",
  "filled_slots": {
    "sector_focus": "DeFi",
    "stage": "seed",
    "limit": 10
  },
  "output_fields": ["name", "website", "focus_area", "tier", "rationale"],
  "context": null
}