Research

Get research run by ID

Retrieve one saved research run, including the plan, evidence, and per-iteration working state.

get/v1/research-run/{research_run_id}

Request

  • Base URL: https://agent.tinyfish.ai
  • URL: https://agent.tinyfish.ai/v1/research-run/{research_run_id}
  • Auth: API key in header X-API-Key

Path parameters

research_run_idstring required

Research run identifier

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Response

Research run

research_run_idstring required

Unique research run identifier

status'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' | 'TIMED_OUT' | 'QUEUED' required

Current status of the research run

querystring required

The research query

quick_result_summarystring nullable required

Short prose summary of the quick result

run_idsstring[] required

IDs of the agent runs spawned by this research run

created_atstring nullable required

ISO 8601 timestamp when the research run was created

completed_atstring nullable required

ISO 8601 timestamp when the research run completed, or null if still running

iterationsinteger nullable required

Number of plan-search-synthesize iterations the run completed

Example response

{
  "research_run_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "COMPLETED",
  "query": "What are the latest AI safety papers?",
  "deep_result": {
    "freshness_report": {
      "filter_applied": {
        "domain_type": "news",
        "after_date": "2024-01-01",
        "before_date": "2024-12-31",
        "recency_minutes": 60
      }
    }
  },
  "run_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ],
  "created_at": "2026-01-01T12:00:00Z",
  "completed_at": "2026-01-01T12:05:00Z",
  "error": {
    "code": "INVALID_INPUT",
    "message": "Field \"url\" is required and must be a string"
  },
  "iterations": 3
}

Changes

No recorded changes to this operation across all 1 revision of this API.