> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/enrichments/find-hiring-manager/individual-lookup.md).

# Individual Lookup

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

<mark style="color:green;">`POST`</mark> `/find_hiring_manager`

{% hint style="info" %}
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.
{% endhint %}

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**

{% tabs %}
{% tab title="Input" %}

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

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "person_name": "Lydia Vazquez",
    "first_name": "Lydia",
    "last_name": "Vazquez",
    "current_title": "President & Chief Executive Officer",
    "email": "lvazquez@aligncu.com",
    "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
}
```

{% endtab %}

{% tab title="Not found" %}

```json
{
  "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
}
```

{% endtab %}
{% endtabs %}

**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](/enrichments/find-hiring-manager/list-lookup.md).