Skip to main content
POST
/
v1
/
hiring-signals
/
leavers
Trigger Leavers
curl --request POST \
  --url https://api.automindz.co/v1/hiring-signals/leavers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "org_name": "<string>",
  "ai_ark_api_key": "<string>",
  "exa_api_key": "<string>",
  "openrouter_api_key": "<string>",
  "industries": [
    "<string>"
  ],
  "job_titles": [
    "<string>"
  ],
  "geography": [
    "<string>"
  ],
  "dm_titles": [
    "<string>"
  ],
  "limit": 5,
  "ai_ark_credits_before": 0,
  "employee_size_ranges": [],
  "tenure_min_months": 2,
  "tenure_max_months": 4,
  "qualification_criteria": "",
  "dm_exclusion_titles": [],
  "max_dms_per_company": 25
}
'
{
  "run_id": "<string>",
  "status": "<string>"
}
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.
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.

​
Reference data

Values must be lowercase and match LinkedIn industry names.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
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
Only these exact ranges are accepted: 1-10, 11-20, 21-50, 51-100, 101-200, 201-500, 501-1000, 1001-2000, 2001-5000, 5001-10000
  • "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"

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

Identifier for your organization. Used to name output files.

​
ai_ark_api_key
string
required

Your AI Ark API key for people data lookups.

​
exa_api_key
string
required

Your Exa API key for company research.

​
openrouter_api_key
string
required

Your OpenRouter API key for AI qualification.

​
industries
string[]
required

Target industries to search within.

​
job_titles
string[]
required

Job titles to look for when identifying leavers.

​
geography
string[]
required

Geographic regions to search.

​
dm_titles
string[]
required

Decision-maker titles to find.

​
limit
integer
default:5

Maximum number of leavers to find. Set to 0 for no limit.

Required range: x >= 0
​
ai_ark_credits_before
integer
default:0

Your current AI Ark credit balance before the run.

​
employee_size_ranges
EmployeeSizeRange · object[]

Company size filters.

​
tenure_min_months
integer
default:2

Minimum months since the person left their previous role.

Required range: 1 <= x <= 120
​
tenure_max_months
integer
default:4

Maximum months since the person left their previous role.

Required range: 1 <= x <= 120
​
qualification_criteria
string
default:""

Natural language description of what makes a company a good fit.

​
dm_exclusion_titles
string[]

Titles to exclude from decision-maker results.

​
max_dms_per_company
integer
default:25

Maximum number of decision-makers to return per company.

Required range: x >= 1

Response

Successful Response

​
run_id
string
required

Unique identifier for this pipeline run.

​
status
string
required

Initial status of the run.