Individual Lookup

Find one company's hiring manager and get them back directly. Synchronous.

POST /find_hiring_manager

Costs 1 credit, charged only when a person with a valid email is found — the same rate a company in List Lookup costs. While the search runs it briefly holds up to about 5 credits and settles to exactly 1 or 0 when it finishes, so your balance must be at least 1 or the call is refused with a 402. A search can take up to a minute.

Send the company, and when you have them the job's poster (job_poster_name, job_poster_title, job_poster_linkedin_url, as /download_list_jobs returns them) and the title the job reports to.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
domain	string	Company website or bare domain. domain or company_linkedin_url is required.
company_linkedin_url	string	Company LinkedIn page. Used to find the website when domain is not sent.
organization_name	string	The company name. Recommended.
job_poster_name	string	Who posted the job.
job_poster_title	string	The poster's title.
job_poster_linkedin_url	string	The poster's LinkedIn profile.
reports_to_title	string	The title the job reports to, e.g. CFO. Several can be joined with & or /.

Outcomes

status	HTTP	Meaning	Charged
success	200	A hiring manager with a valid email, under data.	1
not_found	200	Nobody with a valid email was found.	No
—	402	Balance under 1 credit. Nothing was searched.	No
—	422	Neither domain nor company_linkedin_url was sent.	No

Example

Input

{
  "api_key": "your_api_key",
  "domain": "aligncu.com",
  "organization_name": "Align Credit Union",
  "reports_to_title": "President & CEO"
}

Output

{
  "status": "success",
  "data": {
    "person_name": "Lydia Vazquez",
    "first_name": "Lydia",
    "last_name": "Vazquez",
    "current_title": "President & Chief Executive Officer",
    "email": "[email protected]",
    "email_status": "valid",
    "person_linkedin_url": "https://www.linkedin.com/in/lydiamvazquez",
    "organization_name": "Align Credit Union",
    "domain": "aligncu.com",
    "company_linkedin_url": null,
    "hiring_manager_source": "reports_to"
  },
  "credits_used": 1,
  "credits_remaining": 3403,
  "credits_per_row": 1,
  "message": null,
  "success": true
}

Not found

{
  "status": "not_found",
  "data": null,
  "credits_used": 0,
  "credits_remaining": 3403,
  "credits_per_row": 1,
  "message": "No hiring manager with a valid email was found. Nothing was charged.",
  "success": true
}

Response

Field	Type	Description
person_name	string	Full name.
first_name	string	First name.
last_name	string	Last name.
current_title	string	Their title.
email	string	Their work email.
email_status	string	Always valid.
person_linkedin_url	string	Their LinkedIn profile.
organization_name	string	The company.
domain	string	The company's bare domain.
company_linkedin_url	string	The company's LinkedIn page, when sent.
hiring_manager_source	string	job_poster, reports_to or fallback_title: how they were found.

The record is under data, alongside status, credits_used and credits_remaining.

To run this against every company on a list in one call instead, use List Lookup.