Reports

Historical reports

Historical daily report data: the companies Frontrun flagged for you each day (the same companies as your daily report email), for a date range or a specific date, optionally filtered by sector. Costs 4 credits. The cheapest way to replay past discoveries or backfill a CRM. Each report carries is_sample: true for the two platform sample reports gifted at signup (real companies, not from your tracked accounts).

get/reports

Request

Base URL: https://frontrun.vc/v1
URL: https://frontrun.vc/v1/reports
Auth: API key in header X-API-Key

Query parameters

datestring date

Return the report for a specific date (YYYY-MM-DD).

sincestring

Example:24h

Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "7d".

sectorstring

Filter companies by sector, description, or name (substring match).

limitinteger

Maximum results to return (default 7, max 30).

cursorstring

Example:frc1_eyJ2IjoxLCJzIjoiOWY0YyIsImQiOiIyMDI2LTA4LTA3In0.Xq9

Opaque watermark from a previous response's next_cursor. Resumes exactly where that run stopped, so a scheduled job that retries neither double counts nor drops records. Overrides since when present. Cursors are signed and scoped to the endpoint, API key and filters; a modified or cross-scope cursor returns 400 with error_code invalid_cursor. Persist next_cursor only AFTER you have processed the response. Cannot be combined with date. Walks forward from the day after the newest report already returned.

Response

Reports.

total_reportsinteger

total_companiesinteger

filterstring nullable

cost_creditsinteger

Credits charged for this call.

has_moreboolean

next_cursorstring nullable

Opaque cursor for the next run. Null while has_more is true: page to the end with offset first, then take the cursor from the final page, otherwise the watermark would skip the pages you never read.

cursor_notestring

Changes

No recorded changes to this operation across all 2 revisions of this API.