FundzKnowledge Base
API Reference

Unified alerts

One call that answers "what changed at this account?": recent funding, leadership hires, acquisitions and, for companies you track with FundzWatch, website changes, with a one-sentence summary. Poll your key accounts on a schedule and alert the owner when something happens.

Quick start

Everything at one company over the last 90 days:

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/unified-alerts?domain=northwindrobotics.com&days_back=90"

Endpoint

GEThttps://api.fundz.net/unified-alerts
A rollup of recent events for one company, with a summary.

Send your API key in the Authorization header. Keys come from Account > API Keys in the app, on a Pro or Strategic plan. Requires an active Pro or Strategic subscription; otherwise 403 with "error": "subscription_required". See Authentication and limits for the daily call allowance and error formats.

Query parameters

ParameterTypeDescription
domainstringThe company's website as a bare domain, for example acme.com. Also turns on the website_changes list, which looks the domain up exactly as you send it, so leave off https:// and www..
organization_idintegerThe company's numeric Fundz id, as an alternative to domain. Slugs are not accepted here. Numeric ids come from daily leads and from meta.company.id on the contacts call.
days_backintegerHow many days back to look. Default 30.
Always check the company matched
If Fundz cannot match the domain or organization_id to a company, the response is not limited to one company: you get the most recent events across all companies (up to 100 of each type). Before alerting anyone, check that the organization names in the response are the company you asked about.

Common uses

Weekly check on a key account
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/unified-alerts?domain=acme.com&days_back=7"
Just the one-line summary, for an agent or a Slack post
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/unified-alerts?organization_id=2099674" | jq -r '.summary.description'

Response

{
  "generated_at": "2026-09-26T12:15:22Z",
  "user": { "email": "you@yourcompany.com", "subscription_active": true, "tier": "Pro" },
  "events": {
    "fundings": [
      { "id": 412345, "organization": "Northwind Robotics", "amount": "$28 Million", "round": "Series A", "date": "2026-09-18", "investors": "Example Ventures, Sample Capital" }
    ],
    "executives": [
      { "id": 99812, "organization": "Northwind Robotics", "name": "Jane Smith", "title": "CFO", "action": "hired", "date": "2026-09-15" }
    ],
    "acquisitions": [],
    "website_changes": [
      { "type": "pricing", "summary": "Added an Enterprise plan", "confidence": 0.95, "detected_at": "2026-09-20T14:00:00Z", "details": null }
    ]
  },
  "summary": {
    "total_signals": 3,
    "funding_events": 1,
    "executive_changes": 1,
    "acquisitions": 0,
    "website_changes": 1,
    "description": "Detected 1 funding event, 1 executive change, 1 website change in the past 90 days"
  }
}
FieldTypeDescription
events.fundingsarray{ id, organization, amount, round, date, investors }. amount is text as recorded; investors is one comma-separated string.
events.executivesarray{ id, organization, name, title, action, date }.
events.acquisitionsarray{ id, acquirer, acquired, amount, date }. amount is usually null because most deals do not disclose a price.
events.website_changesarrayOnly when you pass domain, and only for sites monitored with FundzWatch: { type, summary, confidence, detected_at, details }, up to 20.
summaryobjectCounts per type and description, a plain-English sentence you can pass straight to a person or an agent.

Each list holds up to 100 items, newest first. date is the day Fundz added the event.

Need help with an integration?

Tell us what you are building and we will help you get the right data into it.

Contact Support

Last updated September 2026