Skip to main content
Tool results are records created automatically when Intelligence, Growth, or BD tool calls complete. Each result stores the full output data, metadata, and a reference to the parent chat (if any).

List results

GET /api/v1/results

Return a paginated list of your tool results.

Query parameters

limit
integer
Number of results to return. Default 50, maximum 100.
offset
integer
Pagination offset. Default 0.
tool_name
string
Filter to a specific tool or package name (e.g. "vc-shortlist-v1", "growth_plan", "intelligence_result").
chat_id
string
Filter to results associated with a specific chat UUID.
order_by
string
Sort field: created_at (default) or file_size.
order
string
Sort direction: desc (default) or asc.

Response

results
array
List of lightweight result items.
total
integer
Total number of matching results.
limit
integer
Limit applied.
offset
integer
Offset applied.
cURL
curl "https://api.deepcurrent.app/api/v1/results?tool_name=vc-shortlist-v1&limit=10" \
  -H "Authorization: Bearer $TOKEN"
Response
{
  "results": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tool_name": "intelligence_result",
      "chat_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "chat_title": "DeFi VC Outreach",
      "file_format": "json",
      "file_size": 12480,
      "created_at": "2026-04-08T12:00:00Z",
      "preview": {
        "package_id": "vc-shortlist-v1",
        "records_count": 10,
        "summary": "10 seed-stage DeFi VCs ranked by co-investor signals.",
        "expansion_type": null
      }
    }
  ],
  "total": 1,
  "limit": 10,
  "offset": 0
}

Get a result

GET /api/v1/results/{result_id}

Return a single result with the full result_data payload. Use this for downloading the complete output.
result_id
string
required
UUID of the result.

Response

id
string
UUID of the result.
user_id
string
UUID of the owning user.
chat_id
string
UUID of the associated chat. null if not linked.
chat_title
string
Title of the associated chat.
tool_name
string
Name of the tool that produced this result.
result_data
object
Full output data. Shape depends on the tool. For intelligence results this contains records, summary, records_count, and package_id.
result_metadata
object
Tool-specific metadata (e.g. expansion_type for intelligence expansions).
file_format
string
Format of the stored data.
file_size
integer
Size of result_data in bytes.
created_at
string
ISO 8601 creation timestamp.
cURL
curl https://api.deepcurrent.app/api/v1/results/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer $TOKEN"
Response
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "user_id": "550e8400-e29b-41d4-a716-446655440000",
  "chat_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "chat_title": "DeFi VC Outreach",
  "tool_name": "intelligence_result",
  "result_data": {
    "package_id": "vc-shortlist-v1",
    "records_count": 10,
    "summary": "10 seed-stage DeFi VCs ranked by co-investor signals.",
    "records": [
      {
        "name": "Paradigm",
        "website": "https://paradigm.xyz",
        "focus_area": "DeFi, Infrastructure",
        "tier": "Tier 1",
        "rationale": "Lead investor in multiple seed-stage DeFi protocols."
      }
    ]
  },
  "result_metadata": {},
  "file_format": "json",
  "file_size": 12480,
  "created_at": "2026-04-08T12:00:00Z"
}