---
title: "Normalize Companies in Bulk"
method: POST
path: "/versions/{versionId}/normalize/bulk"
tags: ["Normalize"]
---

# Normalize Companies in Bulk

`POST /versions/{versionId}/normalize/bulk`

> This endpoint requires additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to bulk normalization.

Normalize multiple raw company strings to a list of best matching Lightcast companies.

Supported document types and their expected Content-Type (**Document must be UTF-8 encoded.**):
  * JSON – `application/json`
  * Plain text – `text/plain`

There is a limit of 100 companies per request.

Raw company size is limited to 1kB per company.

## Path parameters

- `versionId` string, required

## Request body

- object
  - `terms` string[], required — Maximum number of terms: `100`
  - `fields` unknown[] — See [/versions/{version}](#versions-version) for available fields.
    - unknown

## Response `200`

OK

- object
  - `data` object[], required
    - `company` object, required
      - `id` string, nullable
      - `name` string, nullable
      - `naics` string, nullable
      - `website` string, nullable
      - `isStaffing` boolean
      - `isFortune1000` boolean
      - `city` string, nullable
      - `state` string, nullable
      - `postal_code` string, nullable
    - `term` string, required

## Other responses

- `400` — bad request
- `401` — unauthorized request
- `404` — requested resource not found
- `413` — request size too large
- `415` — wrong content type for request body

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/revisions/fc66b9877391/schema)