Get Latest Company Research
The newest cited company brief (from a research batch). 404 if the company is missing or was never researched.
API key access
leads:read scope with an API key (ro_pat_...). A signed-in session uses the caller's role./api/v1/companies/{company_id}/research/latestAccess token from /api/v1/auth/login, or an API key (ro_pat_..., RO-176) from /api/v1/workspaces/current/api-keys: the key implies its workspace and needs the route's scope. MCP connectors (/api/v1/mcp only) may use an OAuth access token (ro_oat_..., RO-284).
In: header
Path Parameters
uuidHeader Parameters
Id of the workspace to act on (must be a member).
Response Body
curl -X GET "http://localhost:8000/api/v1/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/research/latest" \ -H "X-Workspace-Id: string"{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
"company_id": "b2e6a1c3-1a5e-44ae-a8fd-81f76fd715cf",
"requested_by_id": "e5a2565f-0ccc-4e3e-ace9-5e0c44253010",
"summary": "string",
"facts": [
{
"property1": null,
"property2": null
}
],
"fit_score": 0,
"fit_reasons": [
"string"
],
"risks": [
"string"
],
"sources": [
{
"property1": null,
"property2": null
}
],
"errors": [
"string"
],
"dropped_facts": 0,
"prompt_id": "string",
"model": "string",
"created_at": "2019-08-24T14:15:22Z"
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}Create Research Batch
Research many leads or companies in the background (202): selected leads, selected companies, or a discovery run's accepted companies. Items run a few at a time within per-run (`max_llm_calls`, searches) and per-day budgets; a used-up budget or an AI quota pauses the batch until it refills. Results reuse lead research and the per-domain cache; company items get a cited company brief. Every claim must cite a fetched source (uncited ones are dropped). 409 over `RESEARCH_BATCH_MAX_ACTIVE`, 429 over the daily item cap, 503 when batch research is off.
Get Latest Research
The newest research result for the lead. 404 if the lead is missing or was never researched.