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). |
Response
{
"reports": [
{
"date": "2026-07-07",
"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[].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. |