> 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-titles.md).

# Normalize Titles

Clean a contact's job title, one title at a time or across a whole Parvenu list. Free.

Job titles copied from LinkedIn often carry the whole headline. `Marketing Director at North River Boats | Passionate about growth` is not something you want in the first line of a cold email.

Normalize Titles cleans them with a fixed set of rules. It cuts the headline text after the title, drops the company name and emojis, fixes broken characters and fixes capital letters (`Vice President Of Sales` becomes `Vice President of Sales`, `Staff Accountant Ii` becomes `Staff Accountant II`).

There is no AI and no lookup. It is plain text work on the title you send, which is why it costs nothing.

### Endpoints

* [Individual Lookup](https://developer.parvenu.io/enrichments/normalize-titles/individual-lookup.md): pass one title, get the clean title back in the response. Synchronous, free.
* [List Lookup](https://developer.parvenu.io/enrichments/normalize-titles/list-lookup.md): pass a `listname`; the API cleans the title on every row in place. Asynchronous, free.

### Examples

| Before                                                               | After                   |
| -------------------------------------------------------------------- | ----------------------- |
| `Marketing Director at North River Boats \| Passionate about growth` | Marketing Director      |
| `Vice President Of Sales`                                            | Vice President of Sales |
| `Staff Accountant Ii`                                                | Staff Accountant II     |
| `I help business owners grow their revenue`                          | Left as it was          |

### Use Cases

* **Use the title in an email.** A clean title reads like a person wrote it. A full headline reads like a mail merge.
* **Group and filter by title.** Cleaned titles match each other, so filters and ICP rules catch more of the right people.

{% hint style="warning" %}
The List Lookup writes **in place**, over the contact's job title. The original is kept and re-read on a later run, so nothing is lost.
{% endhint %}

{% hint style="info" %}
Both endpoints are **free**. No AI, nothing charged.
{% endhint %}

### What it will not do

A headline with no job title in it (`I help business owners...`) comes back **unchanged**, with the reason in `reasons`. A title is never blanked.
