API Reference

Partnerships & Agreements

Access partnership and business agreement data including deal announcements and strategic alliances. Filter by date range, agreement type, location, and industry to track collaboration activity programmatically.

🚀 Quick Start

Get started in seconds. Here's your first API call:

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/agreements?created_from=2025-01-01"

Endpoint

GEThttps://api.fundz.net/agreements
Returns paginated list of partnership agreements and contracts

Authentication

Send your key in the header Authorization: YOUR_API_KEY:

Authorization: YOUR_API_KEY

The API also accepts an OAuth Bearer <token> for ChatGPT/agent integrations, and a logged-in session cookie for in-app use — but partner/API usage uses the Authorization: API_KEY header. Paid plans only — there is no free API tier. An inactive subscription returns 401 with a message pointing to fundz.net/pricing.

Common Use Cases

🤝

Recent Partnership Announcements

Track all new partnerships and agreements from the past 30 days

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/agreements?created_from=2025-09-18"

🎯

Industry-Specific Partnerships

Monitor strategic partnerships in specific industries like healthcare or fintech

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/agreements?industries=Healthcare&created_from=2025-01-01"

📜

Filter by Agreement Type

Narrow results to a specific agreement type with the kind filter (comma-separated for multiple)

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/agreements?kind=partnership&created_from=2025-01-01"

Query Parameters

organization_namestringOPTIONAL

Filter by company name (case-insensitive partial match)

Example: Stripe

created_fromstringOPTIONAL

Filter by created date from (YYYY-MM-DD format)

Example: 2025-01-01

created_tostringOPTIONAL

Filter by created date to (YYYY-MM-DD format)

Example: 2025-12-31

kindstringOPTIONAL

Filter by agreement type, matched against the record's kind field (comma-separated for multiple)

Example: partnership

locationsstringOPTIONAL

Location name (automatically includes all cities within a state). Comma-separated for multiple

Example: California,Texas

industriesstringOPTIONAL

Industry names (comma-separated). Common: Software, Fintech, Healthcare, Biotechnology

Example: Software,Healthcare

number_of_employees_min / number_of_employees_maxintegerOPTIONAL

Filter by the agreement company's employee count

Example: number_of_employees_min=50

money_raised_min / money_raised_maxintegerOPTIONAL

Filter by associated deal/funding amount range (where present on the record)

Example: money_raised_min=1000000

pageintegerOPTIONAL

Page number for pagination (default: 1)

Example: 1

Response Format

200 OKSuccess

{
  "data": [
    {
      "id": "acme-corp-partners-with-techco-2025",
      "title": "Acme Corp partners with TechCo",
      "kind": "partnership",
      "created_at": "2025-10-12T14:30:00.000Z",
      "money_raised": "$0",
      "organization": {
        "id": "acme-corp",
        "name": "Acme Corp",
        "number_of_employees": 240,
        "is_public_company": false,
        "status_label": "Private",
        "status_code": "private",
        "ticker": null,
        "list_badges": [],
        "location": {
          "id": 812,
          "title": "Seattle",
          "short_description": "Seattle, Washington",
          "country": "United States"
        },
        "industries": [
          {
            "id": 17,
            "title": "Software"
          }
        ]
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": 2,
    "total_count": 178,
    "total_pages": 8,
    "tier": "Pro",
    "remaining_searches": 97
  },
  "upgrade_url": "https://www.fundz.net/pricing"
}

Response Fields

Each record in data contains the following fields:

Field	Type	Description
id	string	Slug identifier for the agreement record
title	string	Headline of the agreement / partnership announcement
kind	string	Agreement type (e.g. partnership)
created_at	string	ISO 8601 timestamp the record was added
money_raised	string	Associated deal value formatted as currency (e.g. "$0" when none)
organization	object	The company on the agreement (see below)

organization object

Field	Type	Description
id	string	Company slug identifier
name	string	Company name
number_of_employees	integer	Approximate employee count
is_public_company	boolean	Whether the company is publicly traded
status_label	string	Human-readable public/private status
status_code	string	Machine status code (e.g. "private")
ticker	string \| null	Stock ticker symbol for public companies
list_badges	array	Recent list memberships (e.g. Inc 5000); empty when none
location	object	Location with id, title, short_description, country
industries	array	Industries, each with id and title

Pagination & Limits

Results are paginated with ?page=N (25 records per page). The meta object reports current_page, next_page, total_count, and total_pages. Query limits vary by plan; meta.remaining_searches shows what's left and meta.tier shows the caller's plan. 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. The Fundz API is available on paid plans only.

Errors

Errors return JSON in the form { "error": "<Type>", "message": "..." }. Common statuses: 401 (authentication required / invalid token / subscription inactive), 403 (forbidden), 404 (not found), 400 (bad/missing param), 422 (invalid).

💬

Need Help?

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

Contact Support

Was this helpful?

PreviousExecutives NextProducts

Authentication & API Keys Company Profile Fundings