FundzKnowledge Base
API Reference

Executive Changes

Access executive appointment and leadership change data including position titles, hire dates, and organization details. Filter by date range, position type, company size, location, and industry to track C-suite movements programmatically.

🚀 Quick Start

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

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/executives?positions=CEO&created_from=2025-01-01"

Endpoint

GEThttps://api.fundz.net/executives
Returns a paginated list of executive-move / leadership-change events with company and contact details. Index/list only — there is no per-record show endpoint.

Authentication

Send your key in the header 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.

Authorization: YOUR_API_KEY

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

👔

Track CEO Changes

Monitor CEO appointments and departures across industries

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/executives?positions=CEO&created_from=2025-01-01"
🎯

Tech Leadership in Mid-Size Companies

Find CTO appointments in software companies with 50-500 employees

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/executives?positions=CTO&industries=Software&number_of_employees_min=50&number_of_employees_max=500"
📍

Regional Executive Moves

Track C-suite changes in specific locations

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/executives?locations=New%20York&positions=CFO"

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
positionsstringOPTIONAL

Position titles (comma-separated). Common: CEO, CTO, CFO, COO, VP Engineering

Example: CEO,CTO
number_of_employees_minintegerOPTIONAL

Minimum number of employees at the company

Example: 50
number_of_employees_maxintegerOPTIONAL

Maximum number of employees at the company

Example: 500
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
pageintegerOPTIONAL

Page number for pagination (default: 1)

Example: 1

Response Format

200 OKSuccess
{
  "data": [
    {
      "id": "acme-corp-appoints-jane-smith-as-ceo-a4b2",
      "title": "Acme Corp Appoints Jane Smith As CEO",
      "created_at": "2025-10-15T09:23:15.000Z",
      "organization": {
        "id": "acme-corp",
        "name": "Acme Corp",
        "number_of_employees": 250,
        "is_public_company": false,
        "status_label": "Private",
        "status_code": "private",
        "ticker": null,
        "list_badges": [],
        "location": {
          "id": 42,
          "title": "San Francisco",
          "short_description": "San Francisco, CA",
          "country": "United States"
        },
        "industries": [
          { "id": 7, "title": "Software" }
        ]
      },
      "related_contacts": [
        {
          "id": 90871,
          "first_name": "Jane",
          "photo_url": null,
          "positions": [
            { "id": 3, "title": "CEO" }
          ]
        }
      ]
    }
  ],
  "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"
}

Each record is an executive-move / leadership-change event. The organization object carries the company profile, and related_contacts lists the people associated with the event (with their positions).

FieldTypeDescription
idstringStable slug identifying the executive-change event
titlestringHuman-readable event headline (e.g. "Acme Corp Appoints Jane Smith As CEO")
created_atstringISO 8601 timestamp the event was recorded
organizationobjectCompany profile (see fields below)
related_contactsarrayPeople associated with the event

organization object

FieldTypeDescription
idstringCompany slug
namestringCompany name
number_of_employeesintegerEmployee count (may be null)
is_public_companybooleanWhether the company is publicly traded
status_labelstringDisplay status (e.g. "Private", "Public")
status_codestringMachine status code
tickerstringPublic-company ticker symbol (null if private)
list_badgesarrayList memberships (e.g. Inc 5000); empty when none
locationobjectid, title, short_description, country
industriesarrayObjects of id, title

related_contacts[] object

FieldTypeDescription
idintegerContact identifier
first_namestringContact first name
photo_urlstringContact photo URL (may be null)
positionsarrayObjects of id, title (the contact’s role titles)

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 the limit.

Errors

Errors return JSON in the form { "error": "<Type>", "message": "..." }. Common statuses:

StatusMeaning
401Authentication required / invalid token / subscription inactive
403Forbidden
404Not found
400Bad or missing parameter
422Invalid
💬

Need Help?

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

Contact Support