API Reference

Data Models

Reference for the data structures returned by the Fundz feed endpoints. The list endpoints (/fundings, /acquisitions, /crowdfundings, /executives, /agreements, /products) all return the same envelope, wrapping records serialized by each resource's model.

Response Envelope

Every feed endpoint returns a JSON object with data (the array of records, serialized by that resource's model), meta (pagination + plan info), and an upgrade_url.

{
  "data": [ /* array of records, serialized by that resource's Blueprint */ ],
  "meta": {
    "current_page": 1,
    "next_page": 2,
    "total_count": 1234,
    "total_pages": 50,
    "tier": "Pro",
    "remaining_searches": 97
  },
  "upgrade_url": "https://www.fundz.net/pricing"
}

When a query returns nothing, the response also includes a guidance object with a message and suggestions, and that query does NOT count against your limit.

Meta (Pagination & Plan)

current_pageintegerCurrent page number (1-indexed)

next_pageinteger|nullNext page number, or null if on last page

total_countintegerTotal number of matching results across all pages

total_pagesintegerTotal number of pages of results

tierstringThe caller's plan (e.g. "Pro", "Strategic")

remaining_searchesintegerQueries left under your plan's limit

Use ?page=2 to paginate. Page size is 25 records. Query limits vary by plan; meta.remaining_searches shows what's left and meta.tier shows your plan.

Organization

The company associated with an event. These base fields appear on the organization object across every feed.

idstringUnique slug identifier for the company (e.g. "onelayer")

namestringCompany display name

number_of_employeesinteger|nullEstimated employee count

is_public_companybooleanWhether the company is publicly traded

status_labelstring|nullHuman-readable public/private status

status_codestringMachine-readable status code

tickerstring|nullStock ticker for public companies

list_badgesstring[]Recent list memberships (e.g. Inc 5000, Forbes Cloud 100); empty array when none

locationLocationCompany headquarters location

industriesIndustry[]Array of industry classifications

The /fundings feed serializes its company with an enriched view that adds these fields on top of the base set:

descriptionstring|nullShort company description

linkedin_urlstring|nullCompany LinkedIn profile URL

foundedstring|nullYear the company was founded (e.g. "2021")

domainDomainCompany website + brand (see Domain model below)

"organization": {
  "id": "onelayer",
  "name": "OneLayer",
  "number_of_employees": 45,
  "is_public_company": false,
  "status_label": "Private",
  "status_code": "private",
  "ticker": null,
  "list_badges": [],
  "location": {
    "title": "Boston",
    "country": "United States"
  },
  "industries": [
    { "title": "Network Security" }
  ],
  "founded": "2021",
  "description": "OneLayer secures private cellular networks.",
  "linkedin_url": "https://www.linkedin.com/company/onelayer",
  "domain": {
    "name": "onelayer.com",
    "url": "https://onelayer.com",
    "website": "https://onelayer.com",
    "logo": "https://www.google.com/s2/favicons?domain=onelayer.com&sz=128",
    "description": "Securing private cellular networks"
  }
}

Location

titlestringCity or region name (e.g. "San Francisco", "London")

countrystringCountry name (e.g. "United States", "United Kingdom")

Domain

The company's website and brand basics, nested under organization.domain.

namestringBare domain host (e.g. "onelayer.com")

urlstring|nullCanonical website URL

websitestring|nullWebsite URL (falls back to the bare domain when url is absent)

logostring|nullCompany logo / icon URL

descriptionstring|nullShort description from the company site

Investor

An investor in a funding round. Returned in the investors array on each funding.

idintegerUnique investor identifier

titlestringInvestor name

Industry

titlestringIndustry classification (e.g. "Software", "Fintech", "Healthcare")

Event Models

Each endpoint returns events with these endpoint-specific fields, plus the shared organization object above.

Funding Round

GET/fundings

idstringUnique slug identifier for the event

titlestringHuman-readable event title

seriesstring[]Funding stage(s): e.g. "Seed", "Series A", "Series B"

money_raisedstringFormatted amount raised (e.g. "$28,000,000")

created_atdatetimeISO 8601 timestamp of when the event was detected

source_urlstring|nullAnnouncement or filing URL the round was sourced from

use_of_proceedsstring[]Categorized spend intents extracted from the announcement; empty array when not yet available

investorsInvestor[]Investors in the round (see Investor model above)

organizationOrganizationCompany that raised funding (enriched view — see Organization model above)

View full Fundings endpoint docs →

Acquisition

GET/acquisitions

idstringUnique slug identifier for the event

titlestringHuman-readable event title (e.g. "BigTech acquires Startup XYZ")

created_atdatetimeISO 8601 timestamp

acquirersOrganization[]Acquiring company / companies (full Organization records)

acquireesOrganization[]Company / companies being acquired (name-only Organization records: id, name, status fields)

View full Acquisitions endpoint docs →

Executive Move

GET/executives

idstringUnique slug identifier for the event

titlestringEvent title (e.g. "Acme Corp appoints Jane Smith as CEO")

created_atdatetimeISO 8601 timestamp

organizationOrganizationCompany where the hire/change occurred

related_contactsRelatedContact[]People associated with the move (see RelatedContact model below)

Each related_contacts entry carries:

idintegerUnique contact identifier

first_namestringContact's first name

photo_urlstring|nullProfile photo URL

positionsPosition[]Roles held; each Position has id and title

View full Executives endpoint docs →

Agreement / Contract

GET/agreements

idstringUnique slug identifier for the event

titlestringAgreement/contract description

kindstringType/category of the agreement

money_raisedstringFormatted contract value when available

created_atdatetimeISO 8601 timestamp

organizationOrganizationCompany involved

View full Agreements endpoint docs →

Product Launch

GET/products

idstringUnique slug identifier for the event

titlestringProduct launch description

created_atdatetimeISO 8601 timestamp

organizationOrganizationCompany that launched the product

View full Products endpoint docs →

Crowdfunding

GET/crowdfundings

idstringUnique slug identifier for the event

titlestringCrowdfunding campaign title

offerred_typestring|nullType of security offered

offering_amountstringFormatted offering amount (USD)

deadline_datedate|nullOffering deadline

created_atdatetimeISO 8601 timestamp

portalstring|nullFunding portal name

portal_urlstring|nullFunding portal URL

filingstring|nullFiling identifier

sec_urlstring|nullLink to the EDGAR filing-index page

issuer_namestring|nullIssuer's legal name

issuer_websitestring|nullIssuer website

issuer_phonestring|nullIssuer phone number

issuer_contact_namestring|nullIssuer contact name

street1 / street2 / city / state / zip_codestring|nullIssuer mailing address fields

tierstring|nullReg A offering tier (null for Reg CF)

financialsobject|nullReg A financials (total_assets, total_revenues, net_income, etc.) when available

jurisdictionsstring[]|nullReg A offering jurisdictions when available

issuer_organizationOrganizationCompany running the campaign (see Organization model above)

View full Crowdfundings endpoint docs →

Common Query Parameters

Accepted by the feed endpoints. Omit ones that don't apply to a given resource.

pageintegerPage number for pagination (default: 1, 25 records per page)

organization_namestringFilter by company name (case-insensitive partial match, e.g. "stripe" matches "Stripe, Inc.")

created_fromdateEvents created on or after this ISO date (YYYY-MM-DD)

created_todateEvents created on or before this ISO date (YYYY-MM-DD)

money_raised_min / money_raised_maxnumberFilter by amount-raised range

number_of_employees_min / number_of_employees_maxintegerFilter by company employee-count range

deadline_from / deadline_todateFilter by offering deadline range (crowdfundings)

offering_amount_min / offering_amount_maxnumberFilter by offering-amount range (crowdfundings)

seriesstringFunding stage(s), comma-separated (fundings)

kindstringAgreement type(s), comma-separated (agreements)

offered_typesstringSecurity type(s), comma-separated (crowdfundings)

locationsstringLocation name(s) — city, state, or country, comma-separated

industriesstringIndustry name(s), comma-separated

investorsstringInvestor name(s), comma-separated (fundings)

positionsstringJob title(s), comma-separated; abbreviations expand (e.g. "CFO" matches "Chief Financial Officer") (executives)

countries / countrystringCountry name(s), comma-separated, e.g. "US,France" (fundings only)

Authentication

Send your key in the Authorization header against the base URL https://api.fundz.net. The API is paid plans only — there is no free API tier; an inactive subscription returns 401 pointing to fundz.net/pricing.

curl -H "Authorization: YOUR_API_KEY" "https://api.fundz.net/fundings"

Find your API key in your account settings at app.fundz.net. (The API also accepts an OAuth Bearer <token> for ChatGPT/agent integrations.) See the Authentication reference for details.

💬

Need Help?

Our team is here to help you get the most out of the Fundz API.

Contact Support

Was this helpful?

PreviousReg A+

Authentication & API Keys Company Profile Fundings

Data Models

Response Envelope

Meta (Pagination & Plan)

Organization

Location

Domain

Investor

Industry

Event Models

Funding Round

Acquisition

Executive Move

Agreement / Contract

Product Launch

Crowdfunding

Common Query Parameters

Authentication

Need Help?

Related articles