Find leavers

Triggers the leavers pipeline, which identifies people who recently left target companies and discovers decision-makers at both their old and new companies. The pipeline runs asynchronously. Use the returned run_id to poll for results.

Request body

org_name

string

required

Identifier for your organization. Used to name output files (e.g., CSV exports will be prefixed with this name).

ai_ark_api_key

string

required

Your AI Ark API key for people data lookups. Get one at ai-ark.com.

exa_api_key

string

required

Your Exa API key for company research. Get one at exa.ai.

openrouter_api_key

string

required

Your OpenRouter API key for AI qualification. Get one at openrouter.ai.

industries

string[]

required

Target industries to search within. Values must be lowercase and match LinkedIn industry names.

["staffing and recruiting", "recruiting", "staffing agency"]

Reference industries list (148 values)

accounting, administration of justice, advertising services, airlines and aviation, alternative dispute resolution, alternative medicine, animation and post-production, appliances electrical and electronics manufacturing, architecture and planning, armed forces, artists and writers, automation machinery manufacturing, aviation and aerospace component manufacturing, banking, beverage manufacturing, biotechnology research, book and periodical publishing, broadcast media production and distribution, business consulting and services, capital markets, chemical manufacturing, civic and social organizations, civil engineering, computer and network security, computer games, computer hardware manufacturing, computer networking products, computers and electronics manufacturing, construction, consumer services, dairy product manufacturing, defense and space manufacturing, design services, e-learning providers, education administration programs, entertainment providers, environmental services, events services, executive offices, facilities services, farming, financial services, fisheries, food and beverage manufacturing, food and beverage services, freight and package transportation, fundraising, furniture and home furnishings manufacturing, gambling facilities and casinos, glass ceramics and concrete manufacturing, government administration, government relations services, graphic design, higher education, hospitality, hospitals and health care, human resources services, individual and family services, industrial machinery manufacturing, information services, insurance, international affairs, international trade and development, investment banking, investment management, it services and it consulting, law enforcement, law practice, leasing non-residential real estate, legal services, legislative offices, libraries, machinery manufacturing, manufacturing, maritime transportation, market research, media production, medical equipment manufacturing, medical practices, mental health care, mining, mobile gaming apps, motor vehicle manufacturing, movies videos and sound, museums historical sites and zoos, musicians, nanotechnology research, newspaper publishing, non-profit organizations, oil and gas, online audio and video media, outsourcing and offshoring consulting, packaging and containers manufacturing, paper and forest product manufacturing, performing arts, personal care product manufacturing, pharmaceutical manufacturing, philanthropic fundraising services, photography, plastics manufacturing, political organizations, primary and secondary education, printing services, professional training and coaching, public policy offices, public relations and communications services, public safety, railroad equipment manufacturing, ranching, real estate, recreational facilities, religious institutions, renewable energy semiconductor manufacturing, research services, restaurants, retail, retail apparel and fashion, retail art supplies, retail groceries, retail luxury goods and jewelry, retail office equipment, security and investigations, semiconductor manufacturing, shipbuilding, software development, spectator sports, sporting goods manufacturing, staffing and recruiting, strategic management services, technology information and internet, telecommunications, textile manufacturing, think tanks, tobacco manufacturing, translation and localization, transportation logistics supply chain and storage, travel arrangements, truck transportation, utilities, venture capital and private equity principals, veterinary services, warehousing and storage, wellness and fitness services, wholesale, wholesale building materials, wholesale import and export, wireless services, writing and editing

job_titles

string[]

required

Job titles to look for when identifying leavers. Case-insensitive.

["ceo", "coo", "cfo", "managing director", "director"]

Preset title lists

C-suite + VPs (staffing/recruiting default): ceo, coo, cfo, cro, chief executive officer, chief operating officer, chief financial officer, chief revenue officer, director, managing director, vice president, senior vice president, associate director, regional director, national director, head of practice, billing managerTech leadership: cto, vp engineering, head of engineering, director of engineering, vp product, head of product, chief technology officerSales leadership: cro, chief revenue officer, vp sales, vice president of sales, head of sales, sales director, director of sales, vp business development, head of business development

geography

string[]

required

Geographic regions to search. Use country names or broad regions.

["United States"]

Examples: ["United States"], ["Germany", "Austria", "Switzerland"], ["North America"], ["United Kingdom"]

dm_titles

string[]

required

Decision-maker titles to find at the leaver’s old and new companies. These are the people you want to reach out to.

["founder", "ceo", "chief executive officer", "coo", "chief operating officer",
 "cro", "chief revenue officer", "managing director", "president"]

Recommended defaults

founder, ceo, chief executive officer, coo, chief operating officer, cro, chief revenue officer, cso, chief strategy officer, chief sales officer, managing director, president, executive vice president

limit

integer

default:5

Maximum number of leavers to find. Set to 0 for no limit. Common values: 5, 10, 20.

Timing guidance: limit=5 takes ~2-3 minutes. limit=10 takes ~5-7 minutes. limit=0 (no limit) can take 15-30+ minutes depending on available data.

ai_ark_credits_before

integer

default:0

Your current AI Ark credit balance before the run. Pass this so the pipeline can report how many credits were consumed in the results.

employee_size_ranges

object[]

default:"[]"

Company size filters. Each object needs a start and end field. Copy-paste the ranges you need:

Micro: {"start": 1, "end": 10}
Small: {"start": 11, "end": 50}
Mid-market: {"start": 51, "end": 200}
Upper mid-market: {"start": 201, "end": 500}
Enterprise: {"start": 501, "end": 1000}
Large enterprise: {"start": 1001, "end": 5000}

Full example

[
  {"start": 11, "end": 50},
  {"start": 51, "end": 200},
  {"start": 201, "end": 500}
]

| 1001-5000 | Large enterprise |

tenure_min_months

integer

default:2

Minimum months since the person left their previous role. Accepted range: 1-120.Together with tenure_max_months, this defines the recency window. For example, tenure_min_months=2 and tenure_max_months=4 means “find people who left 2 to 4 months ago.” The default window of 2-4 months targets recent movers who are settled enough to be relevant but still in a hiring mindset.

tenure_max_months

integer

default:4

Maximum months since the person left their previous role. Accepted range: 1-120. Must be greater than or equal to tenure_min_months.

qualification_criteria

string

default:""

Natural language description of what makes a company a good fit. The AI uses this to filter and qualify companies.

Example criteria

"recruitment agency based in the United States that primarily serves professional services, tech, or financial services sectors with specialist/executive-level placements and substantial deal sizes"
"technology or SaaS company based in North America with B2B sales motion and meaningful revenue or growth trajectory"
"healthcare staffing firm with over 50 employees focusing on travel nursing or locum tenens placements"

dm_exclusion_titles

string[]

default:"[]"

Titles to exclude from decision-maker results. Use this to filter out titles that are too junior or not relevant for your outreach.

["associate vice president", "senior vice president", "partner", "director"]

max_dms_per_company

integer

default:25

Maximum number of decision-makers to return per company. Caps results to avoid noise when a company has many matching contacts. Default of 25 is usually sufficient.

Response

run_id

string

Unique identifier for this pipeline run. Use this to poll for results.

status

string

Initial status of the run. Always QUEUED on creation.

poll_url

string

Relative URL path to poll for this run’s status and results.

curl -X POST https://api.automindz.co/hiring-signals/leavers \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "limit": 5,
    "org_name": "acme-corp",
    "ai_ark_api_key": "<your-ai-ark-key>",
    "exa_api_key": "<your-exa-key>",
    "openrouter_api_key": "<your-openrouter-key>",
    "industries": ["staffing and recruiting"],
    "employee_size_ranges": [
      {"start": 11, "end": 50},
      {"start": 51, "end": 200}
    ],
    "job_titles": ["ceo", "coo", "managing director"],
    "tenure_min_months": 2,
    "tenure_max_months": 4,
    "qualification_criteria": "recruitment agency in the US",
    "geography": ["United States"],
    "dm_titles": ["founder", "ceo", "president"],
    "dm_exclusion_titles": ["partner", "director"]
  }'

{
  "run_id": "019d678b-c737-213f-f6b2-ed713064874d",
  "status": "QUEUED",
  "poll_url": "/hiring-signals/leavers/runs/019d678b-c737-213f-f6b2-ed713064874d"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

org_name

string

required

ai_ark_api_key

string

required

exa_api_key

string

required

openrouter_api_key

string

required

industries

string[]

required

job_titles

string[]

required

geography

string[]

required

dm_titles

string[]

required

limit

integer

default:5

Required range: x >= 0

ai_ark_credits_before

integer

default:0

employee_size_ranges

EmployeeSizeRange · object[]

Show child attributes

tenure_min_months

integer

default:2

Required range: 1 <= x <= 120

tenure_max_months

integer

default:4

Required range: 1 <= x <= 120

qualification_criteria

string

default:""

dm_exclusion_titles

string[]

max_dms_per_company

integer

default:25

Required range: x >= 1

Response

Successful Response

Overview

Hiring signals

Runs

Request body

Response

Authorizations

Body

Response

Overview

Hiring signals

Runs

​Request body

​Response

Authorizations

Body

Response

Request body

Response