# SiteVerdict — Funding & Filings Tracker (Companies House, SEC) (`siteverdict/siteverdict-funding-filings-tracker`) Actor

Alerts for new funding filings on your watch list: UK share allotments (SH01), charges, accounts and confirmation statements via Companies House (your free key), plus SEC Form D, S-1 and 8-K with offering amounts. Daily Form D radar, Slack/webhook alerts, digests.

- **URL**: https://apify.com/siteverdict/siteverdict-funding-filings-tracker.md
- **Developed by:** [Aman Thakran](https://apify.com/siteverdict) (community)
- **Categories:** Business, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SiteVerdict — Funding & Filings Tracker (Companies House, SEC)

**Be first to know when a company raises money, takes on debt or files results. Watch any list of UK and US companies and get an alert the day a share allotment (SH01), a new bank charge, a Form D private raise, an S-1 or a material 8-K is filed — with the amounts, a plain-English summary and a link to the official document.**

Official sources only: the Companies House Public Data API (with your own free key) and SEC EDGAR (no key). No scraping of news sites, no paywalled databases.

### Three ways teams use it

1. **Sales & partnerships:** a fresh SH01 allotment or a Form D means new money in the bank. Put your target accounts on a daily schedule and get a Slack message when they raise.
2. **Lenders, investors and credit teams:** new charges (MR01) with the lending bank, satisfied charges, late or downgraded accounts, insolvency filings and 8-K items 1.03/2.03/4.02 on one feed.
3. **Deal sourcing:** the **Form D radar** lists every new US private raise in a date range — operating companies only (funds and SPVs filtered out), with offering size, amount sold, investors count, industry and state.

### Before / after

**You give:**

```json
{ "ukCompanies": ["00445790"], "usCompanies": ["AAPL", "2159842"], "companiesHouseApiKey": "•••", "slackWebhookUrl": "•••" }
```

**You get (one row per filing):**

```json
{ "date": "2026-09-30", "jurisdiction": "UK", "companyName": "SAMPLE ROBOTICS LTD", "form": "SH01", "signal": "equity-funding", "significance": "high", "isNew": true,
  "summary": "SAMPLE ROBOTICS LTD: Statement of capital following an allotment of shares on 2026-09-22 (capital now GBP 1,482.35)",
  "links": { "document": "https://find-and-update.company-information.service.gov.uk/company/99100001/filing-history/SAMPLE0SH01A/document?format=pdf&download=0" } }
{ "date": "2026-10-09", "jurisdiction": "US", "companyName": "Hard Pill To Swallow, Inc.", "form": "D", "signal": "private-placement", "significance": "high",
  "summary": "Hard Pill To Swallow, Inc.: New Form D offering of $1.5m, $30k sold to 2 investors (Manufacturing); first sale 2026-09-24; equity; Rule 506(b).",
  "amounts": { "offeringAmount": 1500000, "amountSold": 30000, "currency": "USD" } }
```

plus one free **company digest** per watched company (counts by signal, latest funding/debt/accounts, optional AI digest).

### What is tracked

| Source | Filings | Signal |
|---|---|---|
| Companies House | SH01 allotment of shares (capital figure), other capital changes | `equity-funding`, `share-structure` |
| | MR01 new charge (optionally lender organisations, fixed/floating), MR04 satisfied | `debt-financing`, `debt-repaid` |
| | AA accounts (type: full/small/micro…, made-up date), CS01 confirmation statements, resolutions (new articles, share classes), name changes, insolvency/liquidation | `accounts`, `confirmation-statement`, `resolution`, `name-change`, `insolvency` |
| SEC EDGAR | Form D / D/A with offering amounts parsed from the filing | `private-placement` |
| | S-1, F-1 (+ amendments), 424B prospectuses | `ipo-registration`, `ipo-prospectus` |
| | 8-K with item labels (1.01, 2.01, 2.03, 3.02, 5.01, 5.02…) | `equity-funding` (3.02/2.03), `material-event` |
| | 10-K/10-Q/20-F, SC 13D/13G | `periodic-report`, `ownership-stake` |

Each filing has `significance` (high/medium/low) so you can alert only on what matters.

### Monitoring and alerts

- First run per company = baseline: filings from the last `lookbackDays` (default 90). Later runs = **only new filings** (memory in a named key-value store, `monitorStateName`).
- Schedule it daily; alerts go to Slack and/or any HTTPS webhook (Zapier, Make, n8n) for new filings at or above `alertMinSignificance` (default high).
- `outputMode: all-in-window` turns it into a research tool (everything in the window, `isNew` flags what is new).

### Pricing (pay per event)

| Event | Price | When |
|---|---|---|
| `filing-alert` | $0.003 | a filing row is delivered |
| `offering-details` | $0.004 | Form D amounts/industry/investors parsed for that filing |
| `ai-summary` | $0.01 | an AI digest was produced on your own Anthropic key |

Free: baselines that find nothing, company digests, errors, unchanged runs, sample mode.
**Examples:** a 50-company daily watch list with ~10 new filings/day ≈ **$0.03/day**. Form D radar for one week (~150 operating-company raises with amounts) ≈ **$1.05**.

### Keys

- **Companies House API key (UK companies):** free at developer.company-information.service.gov.uk → Your applications → Create an application → "REST" key. Paste it into `companiesHouseApiKey` (secret, encrypted, never logged).
- **SEC:** no key. Every SEC request sends a declared User-Agent with a contact (hello@webrevenuescan.com) and stays at ≤10 requests/second (default 5), as the SEC fair-access policy asks. Add `secContactEmail` to add your own contact as well.

### FAQ

**Is SH01 always a funding round?** Usually it means new shares were issued for cash (often an investment round, sometimes employee options or founder top-ups). The capital figure is the total nominal capital, not the amount raised; check the document.

**Why do I see funds in the Form D radar?** Funds/SPVs are excluded by default using the Form D industry group (or the name when the document is unavailable). Turn `excludePooledFunds` off to see them.

**Personal data?** Off by default. Names of officers and persons with significant control are never output (officer filings appear as "Appointment of an officer…"), and individuals named as lenders are withheld. The only exception: Form D related persons, if you switch on `includeRelatedPersons` (names and roles, no addresses).

### Limits

- UK: watch list only (Companies House has no public "all new SH01s" feed in the REST API). Up to 1,000 filings per company per run.
- US: the `submissions` API returns the ~1,000 most recent filings per company.
- Form D radar uses the SEC's public EDGAR full-text search index (efts.sec.gov, max 10,000 hits per query); split long date ranges. That index is what sec.gov's own search page uses, but it is **not a documented API**: if it fails or changes format, the run writes an `error` row and says INCOMPLETE in the status and OUTPUT — it never reports a fake "0 filings".
- Max cost per run: when it is reached, unchecked companies get a free `not-processed` row, digests show `filingsNotDelivered`, the status says "N not processed (max total charge reached)", and those filings stay unseen so the next run delivers them. Nothing is charged twice.
- Companies House allows 600 requests per 5 minutes per key; we stay at 500.

### Sources & compliance

- **Companies House Public Data API** (developer-specs.company-information.service.gov.uk), checked 11 Oct 2026. Data under the **Open Government Licence v3.0**: "Contains public sector information licensed under the Open Government Licence v3.0." Used with your own key and within the documented rate limit.
- **SEC EDGAR** APIs (data.sec.gov submissions, www.sec.gov Archives, efts.sec.gov full-text search), checked 11 Oct 2026: US government works, public domain; SEC "Accessing EDGAR Data" fair-access policy followed (declared User-Agent with contact, ≤10 requests/second, default 5).
- UK GDPR/PECR: outputs are company filings. If you use them for outreach you are the controller — have a lawful basis (usually legitimate interests for B2B), follow PECR for electronic marketing, and honour objections.
- Disclaimer: filings as published; summaries are automatic and may miss context; a filing is not proof of a completed round. **Not legal, financial or investment advice.**

Built by SiteVerdict (BharatFare Travel and Technologies Ltd, UK). Contact: hello@webrevenuescan.com.

# Changelog

This Actor's version history is a separate document: https://apify.com/siteverdict/siteverdict-funding-filings-tracker/changelog.md

# Actor input Schema

## `mode` (type: `string`):

<b>Watch list</b>: track new filings for UK company numbers and US CIKs/tickers (first run returns the look-back window, later runs only new filings). <b>Form D radar</b>: every new SEC Form D (private raise) filed in a date range, with amounts, industry and state filters.

## `ukCompanies` (type: `array`):

Companies House numbers, e.g. 00445790, SC123456, OC301234. Needs your Companies House API key below.

## `usCompanies` (type: `array`):

SEC CIKs (320193) or tickers (AAPL). Private companies that only file Form D have a CIK but no ticker.

## `ukCategories` (type: `array`):

capital = share allotments SH01 and other capital changes; mortgage = charges created/satisfied (MR01/MR04); accounts; confirmation-statement; resolution (often new articles/share classes); insolvency/liquidation; officers (events only, names never output).

## `usForms` (type: `array`):

SEC form types to track. Default: D, D/A, S-1, S-1/A, F-1, F-1/A, 8-K, 8-K/A, 10-K, 10-Q, 20-F, 424B4, SC 13D.

## `lookbackDays` (type: `integer`):

On the first run for a company (no memory yet) return filings from the last N days. Later runs return only new filings.

## `outputMode` (type: `string`):

Output.

## `minSignificance` (type: `string`):

high = SH01 allotments, new charges, Form D, S-1, 8-K items 1.01/2.01/2.03/3.02/5.01, insolvency. medium adds accounts, resolutions, CS01 with updates, 10-K. low = everything.

## `maxFilingsPerCompany` (type: `integer`):

Max filings checked per company.

## `includeChargeDetails` (type: `boolean`):

For new UK charges, read the charge register to add the lender (banks, funds) and fixed/floating flags. Individuals named as entitled persons are never output.

## `parseFormD` (type: `boolean`):

Read each Form D to add offering size, amount sold, investors count, industry, exemption and first-sale date (charged as offering-details).

## `includeRelatedPersons` (type: `boolean`):

Off by default. Adds names and roles of executives/directors/promoters listed on Form D (no addresses). You need a lawful basis under UK GDPR.

## `discoveryFrom` (type: `string`):

YYYY-MM-DD. Default: 7 days ago.

## `discoveryTo` (type: `string`):

YYYY-MM-DD. Default: today.

## `discoveryStates` (type: `array`):

e.g. CA, NY, TX; X0 = United Kingdom. Empty = all.

## `excludePooledFunds` (type: `boolean`):

Most Form Ds are funds and SPVs. On by default so you see operating companies raising money.

## `minOfferingAmount` (type: `integer`):

Minimum offering size (USD).

## `industryGroups` (type: `array`):

Keep only these Form D industry groups, e.g. Other Technology, Biotechnology, Health Care, Manufacturing, Retailing, Commercial, Banking & Financial Services.

## `includeAmendments` (type: `boolean`):

Include Form D/A amendments.

## `maxResults` (type: `integer`):

Max filings per run (radar).

## `monitorStateName` (type: `string`):

Memory of filings already seen (a named key-value store in your account). Use different names for different watch lists.

## `alertMinSignificance` (type: `string`):

Alert on new filings of at least.

## `slackWebhookUrl` (type: `string`):

One Slack message per run listing new significant filings. HTTPS only; stored encrypted, never logged.

## `webhookUrl` (type: `string`):

HTTPS endpoint (Zapier, Make, n8n, your CRM). Private/internal addresses are refused. Stored encrypted, never logged.

## `companiesHouseApiKey` (type: `string`):

Free REST API key from developer.company-information.service.gov.uk (Create an application > REST key). Needed for UK companies. Stored encrypted, never logged or written to output.

## `secContactEmail` (type: `string`):

Optional: your own contact, added to the User-Agent sent to the SEC (which always declares the SiteVerdict contact, as the SEC fair-access policy asks).

## `enableAiSummary` (type: `boolean`):

Off by default. Sends only the filing summaries to Anthropic with YOUR key and adds a 3-5 sentence digest. Charged only when produced.

## `anthropicApiKey` (type: `string`):

Your own key from console.anthropic.com. Stored encrypted, never logged or written to output.

## `aiModel` (type: `string`):

Anthropic model.

## `secRequestsPerSecond` (type: `integer`):

SEC requests per second.

## `concurrency` (type: `integer`):

Companies in parallel.

## `sampleMode` (type: `boolean`):

Real SEC responses recorded on 11 Oct 2026 + a fictional Companies House company. No network calls, nothing charged.

## Actor input object example

```json
{
  "mode": "watchlist",
  "ukCompanies": [],
  "usCompanies": [
    "AAPL"
  ],
  "ukCategories": [
    "capital",
    "mortgage",
    "accounts",
    "confirmation-statement",
    "resolution",
    "insolvency",
    "liquidation"
  ],
  "lookbackDays": 90,
  "outputMode": "new-only",
  "minSignificance": "low",
  "maxFilingsPerCompany": 100,
  "includeChargeDetails": false,
  "parseFormD": true,
  "includeRelatedPersons": false,
  "excludePooledFunds": true,
  "minOfferingAmount": 0,
  "includeAmendments": false,
  "maxResults": 200,
  "monitorStateName": "default",
  "alertMinSignificance": "high",
  "enableAiSummary": false,
  "aiModel": "claude-sonnet-5-5",
  "secRequestsPerSecond": 5,
  "concurrency": 3,
  "sampleMode": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `output` (type: `string`):

No description

## `files` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "watchlist",
    "ukCompanies": [],
    "usCompanies": [
        "AAPL"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("siteverdict/siteverdict-funding-filings-tracker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "watchlist",
    "ukCompanies": [],
    "usCompanies": ["AAPL"],
}

# Run the Actor and wait for it to finish
run = client.actor("siteverdict/siteverdict-funding-filings-tracker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "watchlist",
  "ukCompanies": [],
  "usCompanies": [
    "AAPL"
  ]
}' |
apify call siteverdict/siteverdict-funding-filings-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,siteverdict/siteverdict-funding-filings-tracker"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/6PGadvQGk9BWkmQFM/builds/FwjjcnsOp7H1kCPen/openapi.json
