---
title: "Normalize titles in bulk"
method: POST
path: "/versions/{version}/normalize/bulk"
tags: ["Normalize"]
---

# Normalize titles in bulk

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

Normalize multiple raw job title strings to a list of best matching Lightcast titles

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 500 titles per request.

Raw title size is limited to 1kB per title.

> This endpoint requires additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you''d like access to bulk normalization.
> Requesting title [mappings](https://api.emsidata.com/apis/titles#about-data) requires additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to mappings.

## Query parameters

- `confidenceThreshold` number
- `fields` string

## Request body

- object
  - `terms` string[], required — Maximum number of terms: `500`
  - `fields` unknown[] — See [/versions/{version}](#versions-version) for available fields. `mappings` require additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to mappings.
    - unknown
  - `confidenceThreshold` number

## Response `200`

OK

- object
  - `data` object[], required
    - `title` object, required
      - `id` string
      - `name` string
      - `pluralName` string
      - `mapping` object
        - `names` string[], required — Mapping names are included in Titles v4.6 and onward. Titles may have zero or more mappings associated with them, the names of those mappings are listed here and represented in the unified list of skills and socs below.
        - `socs` object[], required
          - `id` string, required
          - `name` string, required
        - `skills` object[], required
          - `id` string, required
          - `name` string, required
      - `isSupervisor` boolean
      - `levelBand` string, nullable
      - `infoUrl` string, nullable
    - `term` string, required
    - `jobLevels` string[], required
    - `confidence` number, 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)