---
title: "Historical reports"
method: GET
path: "/reports"
tags: ["Reports"]
---

# Historical reports

`GET /reports`

## Request

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

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).

## Query parameters

- `date` string, date
- `since` string
- `sector` string
- `limit` integer
- `cursor` string

## Response `200`

Reports.

- object
  - `reports` object[]
    - `date` string, date
    - `is_sample` boolean: True for the two platform sample reports gifted at signup: real companies, but not from your tracked accounts.
    - `total_companies` integer
    - `companies` object[]
      - `handle` string
      - `name` string
      - `sector` string
      - `description` string
      - `confidence` string
      - `tracked_by` string[]: Your tracked accounts that surfaced this company.
      - `website` string
      - `profile_image` string
  - `total_reports` integer
  - `total_companies` integer
  - `filter` string, nullable
  - `cost_credits` integer: Credits charged for this call.
  - `has_more` boolean
  - `next_cursor` string, 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_note` string

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)