---
title: "Your company catalog"
method: GET
path: "/companies"
tags: ["Signal"]
---

# Your company catalog

`GET /companies`

## Request

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

Your company catalog, three parts, each row labelled. (1) source "your_list", via "report": every company in your own daily reports, net new from signup on (the two sample reports gifted at signup are excluded). (2) source "your_list", via "tracked_30d": what the accounts you CURRENTLY track discovered in the last 30 days, dated by when that tracked account first followed it (tracking an account adds its last 30 days, not its all-time history; untracking removes them). (3) source "starter", via "onboarding": a one-time snapshot of up to about 200 companies from the last 30 days in your sectors (the sectors you picked in onboarding, else inferred from your own companies, else AI), built on first use, rebuilt only if your onboarding sectors change, deduped against your own list. Your own list is returned first (reports newest first, then tracked_30d), then starter. Recommended first call for any agent. To see which startups your tracked accounts are converging on, sort by tracked_followers. Costs 4 credits. Needs a key created from a Frontrun account; standalone keys get 400.

## Query parameters

- `sector` string
- `since` string
- `q` string
- `source` 'your_list' | 'starter'
- `limit` integer
- `offset` integer

## Response `200`

Your companies, your own list first.

- object
  - `companies` object[]
    - `username` string
    - `name` string
    - `description` string
    - `sector` string
    - `website` string
    - `profile_image_url` string
    - `followers` integer
    - `stage` string, nullable: Estimated stage, when a starter row carries one. Otherwise null.
    - `flagged_at` string: When the company reached you: report date for report rows, first follow by a tracked account for tracked_30d rows. The since filter applies to this field.
    - `tracked_followers` integer, nullable: How many of YOUR tracked accounts follow this company. null on starter rows.
    - `source` 'your_list' | 'starter': your_list = from your own daily reports or from the accounts you currently track (last 30 days); starter = from your one-time 30-day starter set in your sectors, from the whole Frontrun network.
    - `via` 'report' | 'tracked_30d' | 'onboarding': report = your own daily reports; tracked_30d = discovered by an account you currently track in the last 30 days; onboarding = starter set.
  - `total` integer
  - `counts` object
    - `your_list` integer
    - `starter` integer
  - `seed` object, nullable
    - `chips` string[]
    - `chip_source` 'lens' | 'inferred' | 'default'
    - `window_days` integer
    - `seeded_at` string
  - `has_more` boolean
  - `next_offset` integer, nullable
  - `cost_credits` integer
  - `balance_credits` integer

## Other responses

- `400`: Key was not created from a Frontrun account, or since could not be parsed.
- `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)