FundzKnowledge Base
API Reference

Executive moves

Companies that just hired a new leader: a new CEO, CFO, head of sales or VP of engineering. A new leader usually reviews vendors, builds a team and sets a new plan in their first months, which makes this one of the best moments to reach them. Recruiters use the same feed to spot teams that are about to grow.

Quick start

New CFO appointments Fundz has added since September 1:

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

Endpoint

GEThttps://api.fundz.net/executives
A paginated list of leadership appointments, newest first, 25 per page.

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

Common uses

New CTOs at software companies with 50 to 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"
New sales leaders in New York
curl -H "Authorization: YOUR_API_KEY" \
  "https://api.fundz.net/executives?positions=CRO,VP%20Sales&locations=New%20York"

Query parameters

All parameters are optional.

ParameterTypeDescription
positionsstringJob titles, comma-separated. Each is a partial, case-insensitive match, so VP Sales also finds Senior VP Sales. Common short forms expand to the full title too: CEO, CFO, CTO, CMO, COO, CRO, CHRO, CDO, CISO, CIO, CPO, CSO, CCO, CLO, VP, SVP, EVP (so CFO also matches "Chief Financial Officer").
created_fromdateOnly records Fundz added on or after this date (YYYY-MM-DD). Filters on created_at, the day Fundz captured the event.
created_todateOnly records Fundz added on or before this date (YYYY-MM-DD).
organization_namestringCase-insensitive partial match on the company name.
locationsstringComma-separated place names, matched to Fundz locations. Places inside a match are included, so California covers its cities.
industriesstringComma-separated industry names, exact name match (case-insensitive), for example Software,Fintech. Without this parameter, companies tagged as investment funds are left out.
number_of_employees_minintegerSmallest company headcount to include.
number_of_employees_maxintegerLargest company headcount to include.
employee_rangesstringSeveral size bands at once, comma-separated: 1-49,500-1000,10000- (a trailing dash means no upper limit). A record matches if it falls in any band. Overrides the min and max parameters.
pageintegerPage number, starting at 1. Pages hold 25 records. A page past the end returns an empty data array.

Board seats, advisors, chairs and partners are left out of this feed, so it stays focused on operating leaders.

Check your spelling
Names in positions, locations and industries are looked up one by one. A name that matches nothing is dropped without an error, and if every name is dropped that filter is not applied at all. A typo therefore returns unfiltered results. Compare meta.total_count against what you expect.

Response

{
  "_attribution": "Data provided by Fundz ...",
  "_licensing": "Commercial use, redistribution or embedding requires a licence ...",
  "data": [
    {
      "id": "northwind-robotics-appoints-jane-smith-as-cfo",
      "title": "Northwind Robotics Appoints Jane Smith as CFO",
      "created_at": "2026-09-15T09:23:15.000Z",
      "organization": {
        "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" } ]
      },
      "related_contacts": [
        {
          "id": 90871,
          "first_name": "Jane",
          "photo_url": null,
          "positions": [ { "id": 3, "title": "CFO" } ]
        }
      ]
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": 2,
    "total_count": 1234,
    "total_pages": 50,
    "tier": "Pro",
    "remaining_searches": 41
  },
  "upgrade_url": "https://www.fundz.net/pricing"
}

Records come newest first (by created_at), 25 per page. meta tells you where you are and how many calls you have left today. When nothing matches, the response also carries a guidance object with suggestions. The _attribution and _licensing keys travel with every response; see Authentication and limits.

Executive move fields

FieldTypeDescription
idstringStable slug for the appointment.
titlestringHeadline, for example "Northwind Robotics Appoints Jane Smith as CFO".
created_atstringWhen Fundz added the appointment (ISO 8601).
organizationobjectThe hiring company (base company fields).
related_contactsarrayThe people in the announcement: { id, first_name, photo_url, positions }, where positions is a list of { id, title }.
Need the full name and email?
This feed carries first names only. Call GET /companies/{id}/contacts with the company id to get full names, titles, emails, phone numbers and LinkedIn profiles for the people Fundz holds at that company.

The organization object on this feed carries the base company fields listed on Data models. For website, LinkedIn and description, fetch Company profile with the company id.

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