---
title: "Find decision-makers at a company"
method: POST
path: "/v1/actions/find_decision_makers"
tags: ["Search"]
---

# Find decision-makers at a company

`POST /v1/actions/find_decision_makers`

## Request

- Base URL: `https://api.heyreagent.com`
- URL: `https://api.heyreagent.com/v1/actions/find_decision_makers`
- Auth: HTTP bearer

Find the people at one company by title, seniority and function, through a shared Sales Navigator seat.

confirm false (the default) only previews: how many match and what it costs, no people. confirm true returns them and charges 0.02 credits a person.

company is a NAME. A company id passed there is searched as words; to search by id use search_people_sales_navigator with companyIds.

action is "preview", "blocked" or "results". leads, returned and creditsCharged are present only on "results". There is no next page.

Docs: https://heyreagent.com/docs/actions/find_decision_makers

## Request body

- object
  - `company` string, required: Company name, e.g. "Stripe". Resolved to the LinkedIn company automatically.
  - `titles` string[]: Specific senior roles to target, e.g. ["VP of Sales","Head of Growth"]. Omit for the full decision-maker set (C-level/VP/Director/Founder).
  - `seniorities` string[]: Narrow by seniority level, e.g. ["CXO","VP","Director"] (owner/partner, cxo, vice_president, director, experienced_manager, entry_level_manager, strategic, senior, entry_level, in_training).
  - `functions` string[]: Narrow by job function/department, e.g. ["Sales","Marketing","Engineering"].
  - `locations` string[]: Optional person locations to narrow to, e.g. ["United States"].
  - `limit` number: Max people to return (1–100, default 15).
  - `format` 'table' | 'csv': table (default) = rows for a table. csv = also return an export-ready CSV string.
  - `confirm` boolean: false (default) = cost estimate only. true = pull and charge after the user agreed.

## Response `200`

It worked. Inside result: action, matchCount, estimatedCredits, creditsCharged, yourBalance, returned, leads.

- Worked
  - `ok` true, required
  - `result` object, required: What was asked for. A field that does not apply is left out, or is null.

## Other responses

- `default`: It did not work. The message says why, in plain English.

---

[API](https://skmtc.dev/heyreagent/apis/heyreagent-api.md) · [All operations](https://skmtc.dev/heyreagent/apis/heyreagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heyreagent/apis/heyreagent-api/revisions/917360c5f841?raw)