API Reference

Company profile, contacts and market gift

Everything Fundz knows about one company, in one call: the company record plus its recent funding, acquisitions, leadership hires, contracts, product launches, office expansions and trademark filings. Two companion calls give you the people to contact there and a ready-made opener about what is moving in their market.

Use it to fill in a CRM record, brief a rep before a call, or give an AI agent the context it needs to write a message that lands.

Quick start

Pass a company slug (the organization.id on any feed record) or its numeric Fundz id:

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/companies/northwind-robotics"

Endpoints

GEThttps://api.fundz.net/companies/{id}

The company record plus its recent signals.

GEThttps://api.fundz.net/companies/{id}/contacts

Up to 25 people Fundz holds at the company, with email, phone and LinkedIn where known.

GEThttps://api.fundz.net/companies/{id}/market_gift

A short, factual note about what is moving in the company's market, written to open a conversation.

Send your API key in the Authorization header. Keys come from Account > API Keys in the app, on a Pro or Strategic plan. Each of these three calls counts once against your daily allowance. See Authentication and limits for the daily call allowance and error formats.

The id path parameter

Either the company slug (for example northwind-robotics, returned as organization.id on every feed) or the numeric Fundz id (returned by daily leads and by the contacts call). When Fundz holds duplicate records for a company, both resolve to the same main record. An unknown id returns 404 with "message": "Company not found".

GET /companies/{id}

{
  "data": {
    "id": "northwind-robotics",
    "name": "Northwind Robotics",
    "number_of_employees": 85,
    "is_public_company": false,
    "status_label": "PRIVATE",
    "status_code": "private",
    "ticker": null,
    "list_badges": [],
    "location": { "id": 812, "title": "Austin", "short_description": "Austin, Texas", "level": "city", "country": "United States", "release_count": 2140 },
    "industries": [ { "id": 47, "title": "Robotics" } ],
    "description": "Northwind builds warehouse picking robots.",
    "linkedin_url": "https://www.linkedin.com/company/northwind-robotics",
    "founded": "2021",
    "domain": { "id": 90211, "name": "northwindrobotics.com", "url": "https://northwindrobotics.com", "website": "https://northwindrobotics.com", "description": "Warehouse robotics", "logo": "https://www.google.com/s2/favicons?domain=northwindrobotics.com&sz=128" },
    "signals": {
      "fundings": [
        {
          "id": "northwind-robotics-funding-round-4b2c1a",
          "stage": "Series A",
          "amount": "$28 Million",
          "amount_usd": 28000000,
          "date": "2026-09-18T14:23:15.000Z",
          "source_url": "https://example.com/northwind-series-a",
          "investors": ["Example Ventures", "Sample Capital"],
          "use_of_proceeds": [ { "category": "Hiring", "detail": "Double the engineering team", "confidence": 0.9 } ]
        }
      ],
      "acquisitions": [],
      "executives": [
        { "id": "northwind-robotics-appoints-jane-smith-as-cfo", "name": "Jane Smith", "title": "CFO", "action": "hired", "date": "2026-09-15T09:23:15.000Z" }
      ],
      "agreements": [
        { "id": "northwind-robotics-partners-with-harbor-systems", "title": "Northwind Robotics partners with Harbor Systems", "kind": "partnership", "date": "2026-09-12T14:30:00.000Z" }
      ],
      "product_launches": [],
      "sec_filings": [],
      "expansions": [
        { "city": "Austin", "address": "500 Example St", "permit_type": "Tenant Improvement", "status": "Issued", "cost_usd": 250000, "filed_at": "2026-08-18", "owner": "Northwind Robotics" }
      ],
      "trademarks": [
        { "mark": "PICKPRO", "filing_date": "2026-07-30", "status": "pending", "classes": [9, 42] }
      ]
    },
    "counts": { "fundings": 1, "acquisitions": 0, "executives": 1, "agreements": 1, "product_launches": 0, "sec_filings": 0, "expansions": 1, "trademarks": 1 },
    "last_signal_at": "2026-09-18T14:23:15.000Z"
  },
  "meta": { "tier": "Pro", "alt_data": "included" }
}

The company fields match the enriched company record described on Data models. On top of them:

Field	Type	Description
signals	object	Recent events grouped by type. Each list holds up to the 10 most recent. If one type cannot be loaded it comes back as an empty list rather than failing the whole call.
counts	object	How many items each list in `signals` holds (at most 10 each).
last_signal_at	string \| null	Timestamp of the most recent item across all lists.
meta.tier	string	Your plan.
meta.alt_data	string	`included` when office expansions and trademarks are part of the response, which they are on every paid plan.

What each signal list contains

List	Fields
fundings	`id`, `stage`, `amount` (display text), `amount_usd`, `date`, `source_url`, `investors` (names), `use_of_proceeds` (see Fundings)
acquisitions	`id`, `role` (`acquirer` or `acquiree`), `acquirer`, `acquired`, `amount`, `date`
executives	`id`, `name`, `title`, `action` (always `hired`), `date`
agreements	`id`, `title`, `kind`, `date`
product_launches	`id`, `title`, `date`
sec_filings	`id`, `form_type`, `filed_at`, `url`, `summary`
expansions	Commercial building and lease permits matched to the company, a sign it is adding or fitting out space: `city`, `address`, `permit_type`, `status`, `cost_usd`, `filed_at`, `owner`
trademarks	US trademark filings, a sign of a new product or brand: `mark`, `filing_date`, `status` (`pending`, `registered` or `dead`), `classes`

For a longer history of one type, use its feed with organization_name, for example /fundings.

GET /companies/{id}/contacts

The people Fundz holds at the company, so you can go from "this company just raised" to "this is who to email" in two calls. People with an email address come first, then by department and last name.

Parameter	Type	Description
with_email	boolean	Set to `true` to return only people with an email address.

Decision-makers with an email address

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/companies/northwind-robotics/contacts?with_email=true"

{
  "data": [
    {
      "id": 90871,
      "first_name": "Jane",
      "last_name": "Smith",
      "department": "Finance",
      "bio": null,
      "photo_url": null,
      "email": "jane@northwindrobotics.com",
      "email_locked": false,
      "email_domain": null,
      "organization_id": 2099674,
      "phone_number": "512-555-0100",
      "phone_is_fallback": true,
      "linked_in": "https://www.linkedin.com/in/example",
      "positions": [ { "id": 3, "title": "CFO" } ]
    }
  ],
  "meta": {
    "company": { "id": 2099674, "slug": "northwind-robotics", "name": "Northwind Robotics", "url": "https://app.fundz.net/companies/northwind-robotics" },
    "returned": 1,
    "total_count": 14,
    "tier": "Pro"
  }
}

Field	Type	Description
id, first_name, last_name	integer, string	The person.
positions	array	Their titles, each `{ id, title }`.
department	string \| null	Department, when known.
email	string \| null	Work email, when Fundz holds one.
email_locked, email_domain	boolean, string \| null	Used by the app on plans that hide emails. With API access `email_locked` is `false`.
phone_number	string \| null	The person's phone, or the company's main line when `phone_is_fallback` is `true`.
linked_in	string \| null	LinkedIn profile. When no profile is on file it can be a search link for the person instead.
organization_id	integer	Numeric id of the company record the person is attached to.
meta.returned, meta.total_count	integer	People in this response (up to 25) and people Fundz holds in total.
meta.company	object	The company: numeric `id`, `slug`, `name` and its page in the app.

GET /companies/{id}/market_gift

Most outreach opens with the recipient's own news, which they already know. A market gift opens with something useful they may not know: what is moving among the companies around them, such as "12 companies have appointed a new CFO in the last 90 days, including ...". It is the same opener SmartSend uses.

Parameter	Type	Description
lookback_days	integer	How far back to look, from 14 to 365 days. Default 90.

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/companies/northwind-robotics/market_gift?lookback_days=90"

Field	Type	Description
strong	boolean	Whether there was enough relevant movement to lead with. When `false`, write a normal opener instead of forcing a weak one.
text	string	The gift written out, ready to adapt into a first line.
facts	array	The individual facts behind the text, as sentences.
fact_count	integer	Number of facts.
tier	string \| null	Which kind of gift was found: `buyer_motion` (people who buy from you changed seats), `named_peer`, `adjacency_aggregate`, `geo`, `category_floor`, or `null` when none.
buyer_companies	array	For `buyer_motion` gifts, every company behind the count: `{ company, date, role, org_id }`. Use it to build the list the gift describes.
fingerprint	array	Keywords Fundz used to define the company's market.
lookback_days	integer	The window actually used.
reason	string \| null	Why nothing was found, when that happens.
company	object	`{ id, name, url }` for the company you asked about.

This call does real analysis each time, so it can take several seconds. If it cannot be assembled it returns 503 with "type": "GiftUnavailable"; try again later.

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

Was this helpful?

PreviousAuthentication & API Keys NextFundings

Authentication & API Keys Fundings Crowdfundings