> 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-company-names/individual-lookup.md).

# Individual Lookup

Repair one company name and get it back directly. Synchronous and free.

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

{% hint style="info" %}
**Free.** No provider call, no model call, so nothing is charged and nothing is stored.
{% endhint %}

`company_description` is worth sending when you have it. A company's real spelling is usually already written in its own description, and matching against it is what turns `Planetbids` into `PlanetBids` without a model — it also keeps `Opmed.ai` from losing its suffix. `company_keywords` and `company_website` serve the same purpose. All three are read-only.

**Headers**

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

**Body**

| Name                  | Type   | Description                                                          |
| --------------------- | ------ | -------------------------------------------------------------------- |
| `api_key`             | string | Your API Key.                                                        |
| `organization_name`   | string | The company name to repair.                                          |
| `company_description` | string | Optional, read-only. The best source of the company's real spelling. |
| `company_keywords`    | string | Optional, read-only. Another place a better spelling may appear.     |
| `company_website`     | string | Optional, read-only. Another place a better spelling may appear.     |

**What it repairs**

| Input                                   | Output                 | Why                           |
| --------------------------------------- | ---------------------- | ----------------------------- |
| `Causal Inc All Rights Reserved`        | Causal                 | Leftover website text         |
| `Easescreen - Digital Signage Solution` | Easescreen             | Tagline cut                   |
| `Omnibond Systems Llc.`                 | Omnibond Systems       | Legal suffix                  |
| `Cs Genetics`                           | CS Genetics            | Acronym casing                |
| `Mcenroe Voice And Data`                | McEnroe Voice and Data | Casing                        |
| `Planetbids` + description              | PlanetBids             | Spelling from the description |

**What it leaves alone**

| Input              | Output           | Why                                       |
| ------------------ | ---------------- | ----------------------------------------- |
| `Cooper Companies` | Cooper Companies | The plural is part of the name            |
| `Corp`             | Corp             | As a whole name it is the brand           |
| `Bene : Studio`    | Bene : Studio    | A spaced colon is branding, not a tagline |
| `Re:Amaze`         | Re:Amaze         | The colon is inside the name              |

Any rule chain that removes more than 60% of the name keeps the original instead. Anything it cannot resolve comes back unchanged, with the reason in `reasons`.

**Example**

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

```json
{
  "api_key": "your_api_key",
  "organization_name": "Planetbids",
  "company_description": "PlanetBids is a provider of cloud-based eProcurement software for public agencies."
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "organization_name": "PlanetBids",
    "reasons": ["took the capitalisation from the company description"]
  },
  "credits_used": 0.0,
  "success": true
}
```

{% endtab %}

{% tab title="Left alone" %}

```json
{
  "status": "success",
  "data": {
    "organization_name": "Cooper Companies",
    "reasons": ["already correct, left as it is"]
  },
  "credits_used": 0.0,
  "success": true
}
```

{% endtab %}
{% endtabs %}

**Response**

| Field               | Type   | Description                                                        |
| ------------------- | ------ | ------------------------------------------------------------------ |
| `organization_name` | string | The repaired name, or the original when no rule applied.           |
| `reasons`           | array  | One short line per rule that fired, or the reason nothing changed. |

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

To repair a whole list, use [List Lookup](/enrichments/normalize-company-names/list-lookup.md).