> 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/normalize-hiring-titles/individual-lookup.md).

# Individual Lookup

Clean one hiring title and get it back directly. Synchronous and free.

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

{% hint style="info" %}
**Free.** No AI, so nothing is charged. Returns the clean title directly in the response.
{% endhint %}

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name                | Type   | Description                                                                                      |
| ------------------- | ------ | ------------------------------------------------------------------------------------------------ |
| `api_key`           | string | Your API Key.                                                                                    |
| `hiring_title`      | string | The job post title to clean.                                                                     |
| `organization_name` | string | Optional. The company that posted the job. Text after a dash that names this company is removed. |

**What it cleans**

| Input                                                                     | Output                                    | Why                                          |
| ------------------------------------------------------------------------- | ----------------------------------------- | -------------------------------------------- |
| `Financial Planning & Analysis (FP&A) Intern - Summer 2027`               | Financial Planning & Analysis Intern      | Bracketed text and extras removed            |
| `Senior Performance Auditor (Performance Auditor II)`                     | Senior Performance Auditor                | Bracketed text removed                       |
| `Oracle Fusion ERP and EPM Functional Lead – Record to Report`            | Oracle Fusion ERP and EPM Functional Lead | Extras after the title removed               |
| `Vice President - Sales`                                                  | Vice President, Sales                     | Department kept                              |
| `Engineer - Site Reliability`                                             | Engineer - Site Reliability               | Specialty after a short title kept           |
| `Pharmacist - Walgreens`                                                  | Pharmacist                                | Company after the dash removed               |
| `Representative - Direct Energy` with `organization_name` `Direct Energy` | Representative                            | The hiring company after the dash removed    |
| `NURSE - ICU`                                                             | Nurse - ICU                               | Capitals fixed, known terms kept in capitals |

**Example**

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

```json
{
  "api_key": "your_api_key",
  "hiring_title": "Representative - Direct Energy",
  "organization_name": "Direct Energy"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "hiring_title": "Representative",
    "reasons": ["removed text after the title"]
  },
  "credits_used": 0.0,
  "success": true,
  "credits_remaining": 2523.5
}
```

{% endtab %}
{% endtabs %}

**Response**

| Field          | Type   | Description                                                      |
| -------------- | ------ | ---------------------------------------------------------------- |
| `hiring_title` | string | The clean title, or the original when no rule applied.           |
| `reasons`      | array  | One short line per rule that ran, or the reason nothing changed. |

The record is under `data`. See [Response Format](https://developer.parvenu.io/getting-started/response-format.md) for the fields every endpoint returns.

Use this to see what the rules do before running them over a whole list. To clean a list instead, use [List Lookup](https://developer.parvenu.io/enrichments/normalize-hiring-titles/list-lookup.md). The list run already knows each job's company, so it removes the hiring company on its own.
