API ReferenceResearch

Get a Research Object

Retrieve a single research object by ID.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Response

A research object.
idstringformat: "uuid"
Research job identifier.
created_atdatetime
ISO 8601 timestamp when the job was created.
statusenum

Current status of the research job:

  • queued: Job accepted, waiting to start
  • searching: Gathering sources from the web
  • researching: Processing and analyzing sources
  • analyzing: Deep analysis of gathered information
  • summarizing: Generating final synthesis
  • completed: Research finished successfully
  • failed: Research encountered an error
querystring
Original query.
reasoning_loops_consumedinteger>=0
The actual number of reasoning loops executed during the research. May be less than the requested maximum if early exit was allowed.
running_timeinteger>=0
Total execution time in seconds for the research job.
resultslist of objects
Sources used in the research, ordered by citation index.
contentstring or null

Final synthesized response with inline citations. Citations appear as bracketed numbers (e.g., [1], [2]) that correspond to the citation_index in the results array. Null until research completes.

transformed_contentstring or null

Post-processed content (e.g., formatted/converted).

Errors

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error