Get research status and results

Retrieve the status and results of a deep research task by ID. Supports both standard JSON responses and streaming for real-time updates as the research progresses. Research tasks analyze topics comprehensively using web search and AI synthesis.

GET /search/v1/research/{id}

Get research status and results

cURL

curl --request GET \
  --url https://api.case.dev/search/v1/research/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "research_abc123",
  "status": "completed",
  "query": "Recent developments in AI liability law",
  "model": "pro",
  "results": {
    "summary": "Recent AI liability law developments focus on establishing clear frameworks for algorithmic accountability, with the EU leading regulatory efforts through the AI Act while the US pursues sector-specific approaches.",
    "sections": [
      {
        "title": "EU AI Act Implementation",
        "content": "The European Union's AI Act, which came into force in 2024, establishes a risk-based approach to AI regulation...",
        "sources": [
          {
            "url": "https://example.com/ai-act-analysis",
            "title": "EU AI Act: Legal Framework Analysis",
            "snippet": "The AI Act introduces tiered liability based on risk assessment..."
          }
        ]
      }
    ],
    "sources": [
      {
        "url": "https://example.com/ai-act-analysis",
        "title": "EU AI Act: Legal Framework Analysis",
        "snippet": "The AI Act introduces tiered liability based on risk assessment..."
      }
    ]
  },
  "progress": 100,
  "createdAt": "2024-01-15T10:30:00Z",
  "completedAt": "2024-01-15T10:32:45Z"
}

Authorizations

Authorization · string · header · required

API key starting with sk_case_

Path Parameters

id · string · required

Unique identifier for the research task

Query Parameters

stream · boolean

Enable streaming for real-time updates

events · string

Filter specific event types for streaming

Response

200

application/json

Research status and results

id · string

Research task ID

status · enum<string>

Current status of the research task

Available options: pending, running, completed, failed

query · string

Original research query

model · enum<string>

Research model used

Available options: fast, normal, pro

results · object

Research findings and analysis

Show child attributes

progress · number

Completion percentage (0-100)

createdAt · string<date-time>

Task creation timestamp

completedAt · string<date-time>

Task completion timestamp