> ## Documentation Index > Fetch the complete documentation index at: https://docs.case.dev/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /openapi.json get /search/v1/research/{id} openapi: 3.1.0 info: title: Case.dev API description: >- The AI-native platform for legal technology. Build smarter legal applications with our suite of AI-powered APIs. version: 1.0.0 contact: name: Case.dev Support email: support@casemark.com url: https://case.dev license: name: Proprietary url: https://case.dev/terms servers: - url: https://api.case.dev description: Production security: - bearerAuth: [] tags: - name: Vaults description: Secure document storage with semantic search and GraphRAG - name: Memory description: >- Persistent memory for AI agents with semantic search and 12 generic indexed tag fields - name: OCR description: Extract text from PDFs, images, and scanned documents - name: Voice description: Audio transcription and text-to-speech - name: LLMs description: Access 40+ language models through a unified API - name: Search description: Web search, AI answers, and deep research - name: Mail description: Managed inboxes for agent email workflows - name: Media description: Transcript retrieval and captioned media clip generation - name: Legal description: Legal research tools including citation verification - name: Privilege description: Privilege detection for e-discovery and litigation workflows - name: Compute description: Serverless GPU and CPU infrastructure - name: Format description: Document formatting and template rendering (MD/JSON to PDF/DOCX) - name: SuperDoc description: Document conversion and template automation - name: Webhooks description: Webhook endpoint management - name: System description: Public system metadata and discovery endpoints - name: Usage description: Usage reporting and webhook subscriptions - name: Database description: Serverless PostgreSQL databases with instant branching - name: Translation description: Language detection and translation for multilingual legal workflows - name: Skills description: Search and read legal AI skills for agents - name: Agents description: >- Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows - name: Matters description: Matter-native legal workspaces and orchestration primitives - name: Applications Projects description: Web application project management - name: Applications Deployments description: Web application deployment management - name: Applications Domains description: Custom domain configuration for applications - name: Applications Env Vars description: Environment variable management for applications paths: /search/v1/research/{id}: get: tags: - Search summary: Get research status and results description: >- 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. operationId: getResearch parameters: - name: id in: path required: true schema: type: string description: Unique identifier for the research task - name: stream in: query required: false schema: type: boolean description: Enable streaming for real-time updates - name: events in: query required: false schema: type: string description: Filter specific event types for streaming responses: '200': description: Research status and results content: application/json: schema: type: object properties: id: type: string description: Research task ID status: type: string enum: - pending - running - completed - failed description: Current status of the research task query: type: string description: Original research query model: type: string enum: - fast - normal - pro description: Research model used results: type: object description: Research findings and analysis properties: summary: type: string description: Executive summary of research findings sections: type: array description: Detailed research sections items: type: object properties: title: type: string content: type: string sources: type: array items: type: object properties: url: type: string title: type: string snippet: type: string sources: type: array description: All sources referenced in research items: type: object properties: url: type: string title: type: string snippet: type: string progress: type: number description: Completion percentage (0-100) createdAt: type: string format: date-time description: Task creation timestamp completedAt: type: string format: date-time description: Task completion timestamp example: 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' '400': description: Invalid research ID or parameters '401': description: Invalid API key '403': description: Insufficient permissions for Search service '404': description: Research task not found components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: API key starting with `sk_case_` ````