GET /v1/reports
Historical daily report data. Returns your saved discovery reports - the companies flagged for you each day - for a date range.
Cost: 4 credits per call
curl "https://frontrun.vc/v1/reports?since=7d" \
-H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
since | string (query) | "7d" | How far back to fetch. Values: "7d", "14d", or a start date "YYYY-MM-DD". Ignored if date is set. |
date | string (query) | -- | Fetch a single report for this date (YYYY-MM-DD). |
sector | string (query) | -- | Filter companies by sector, description, or name. Case-insensitive partial match. |
limit | integer (query) | 7 | Maximum reports returned (max 30). |
cursor | string (query) | -- | Opaque watermark from a previous response's next_cursor. Walks forward from the day after the newest report you already received. Cannot be combined with date. See Budgets & Cursors. |
Response
{
"reports": [
{
"date": "2026-07-07",
"is_sample": false,
"total_companies": 2,
"companies": [
{
"handle": "stealth_ai_co",
"name": "StealthAI",
"sector": "AI/ML",
"description": "Automating enterprise workflows with LLMs",
"confidence": "high",
"tracked_by": ["pmarca", "naval"],
"website": "https://stealthai.com",
"profile_image": "https://pbs.twimg.com/profile_images/..."
}
]
}
],
"total_reports": 1,
"total_companies": 2,
"filter": null,
"cost_credits": 4
}| Field | Type | Description |
|---|---|---|
reports | array | One entry per daily report, newest first. |
reports[].is_sample | boolean | true for the two platform sample reports gifted at signup. Their companies are real but did not come from your tracked accounts, so skip them when you want only your own discoveries. |
reports[].companies | array | Companies discovered in that report. |
tracked_by | string[] | Your tracked accounts that followed the company. |
total_reports | integer | Number of reports returned. |
total_companies | integer | Companies across all returned reports. |
filter | string | The sector filter applied, or null. |