API Reference

Data models

The shapes behind every response, in one place: the company record that rides on every event, its nested objects, and the fields of each event type. Each endpoint page shows a full example; use this page when you are mapping fields into your own database or CRM.

Feed envelope

The six feeds (/fundings, /acquisitions, /crowdfundings, /executives, /agreements, /products) wrap their records the same way. See Authentication and limits for pagination and errors.

Field	Type	Description
data	array	The records on this page, up to 25.
meta.current_page	integer	This page number, starting at 1.
meta.next_page	integer \| null	The next page number, or `null` on the last page.
meta.total_count	integer	Records matching your filters across all pages.
meta.total_pages	integer	Number of pages.
meta.tier	string	Your plan, `Pro` or `Strategic`.
meta.remaining_searches	integer	Calls left today.
upgrade_url	string	Link to plans.
guidance	object	Only when nothing matched: suggestions for widening the search.
_attribution, _licensing	string	Whose data this is and how to license it for redistribution.

Company (organization)

Every event carries the company it is about. The base fields appear on all feeds (as organization, or as acquirers / acquirees on acquisitions and issuer_organization on crowdfundings):

Field	Type	Description
id	string	Company slug. Pass it to `GET /companies/{id}` for the full profile.
name	string	Company name.
number_of_employees	integer \| null	Employee count, when known.
is_public_company	boolean	Whether the company is publicly traded.
status_label	string	Display status: `PRIVATE`, `PUBLIC`, `JUST IPO'D`, `TAKEN PRIVATE` or `RECENTLY ACQUIRED`.
status_code	string	Machine status: `private`, `public`, `just_ipod`, `taken_private` or `recently_acquired`.
ticker	string \| null	Stock ticker for public companies.
list_badges	array	Recent list memberships (for example Inc. 5000). Empty when none.
location	object	Headquarters: `{ id, title, short_description, level, country, release_count }`.
industries	array	Industry tags, each `{ id, title }`.

The Fundings feed and Company profile return the enriched record, which adds:

Field	Type	Description
description	string \| null	Short company description.
linkedin_url	string \| null	Company LinkedIn page.
founded	string \| null	Four-digit founding year, when known.
domain	object \| null	Website: `{ id, name, url, website, description, logo }`. `logo` is a favicon-size image URL.

On acquisitions, companies in acquirees carry the base fields without location and industries.

Location

Field	Type	Description
id	integer	Location id.
title	string	Place name, for example `Austin`.
short_description	string	Longer label, for example `Austin, Texas`.
level	string	`continent`, `country`, `region` or `city`.
country	string \| null	Country name.
release_count	integer \| null	How many funding rounds Fundz holds for this place.

Industry

Field	Type	Description
id	integer	Industry id.
title	string	Industry name, for example `Software`. Use these names in the `industries` filter.

Domain

Field	Type	Description
id	integer	Domain id.
name	string	Bare host, for example `northwindrobotics.com`.
url	string \| null	Website URL as stored.
website	string \| null	Website URL, falling back to `https://` plus `name` when `url` is empty.
description	string \| null	Description taken from the website.
logo	string \| null	Favicon-size logo image URL.

Investor

Field	Type	Description
id	integer	Investor id.
title	string	Investor name.

Event records

Each feed adds its own fields to id (a stable slug), title and created_at (when Fundz added the record).

Record	Endpoint	Fields besides id, title, created_at
Funding round	/fundings	`series`, `money_raised`, `source_url`, `use_of_proceeds` (list of `{ category, detail, confidence }`), `investors` (list of Investor), `organization` (enriched)
Acquisition	/acquisitions	`deal_value` (only when reported: `{ amount, currency, amount_usd, source }`), `acquirers`, `acquirees`
Executive move	/executives	`organization`, `related_contacts` (list of `{ id, first_name, photo_url, positions }`)
Agreement	/agreements	`kind`, `money_raised`, `organization`
Product launch	/products	`organization`
Offering (Reg CF / Reg A+)	/crowdfundings	`filing`, `offerred_type`, `offering_amount`, `deadline_date`, `portal`, `portal_url`, issuer contact and address fields, `sec_url`, `tier`, `financials`, `jurisdictions`, `issuer_organization`

Money fields ending in _usd are whole US dollars. Other money fields (money_raised, offering_amount, amount) are display text such as $28 Million or $750,000, and are null when no amount was reported.

Contact

Returned by GET /companies/{id}/contacts: id, first_name, last_name, department, bio, photo_url, email, email_locked, email_domain, organization_id, phone_number, phone_is_fallback, linked_in and positions (list of { id, title }).

Endpoints with their own shapes

Company profile: the enriched company plus signals, counts and last_signal_at.
Daily leads: leads, total, mode, tier, message.
Unified alerts: events, summary, generated_at, user.
SEC 8-K filings: filings, page, per_page, total.
Form D filings: data and meta with per_page.