Skip to main content
POST
/
hiring-signals
/
leavers
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"
}
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"]
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"]
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"]
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}
[
  {"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.
  • "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[]
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