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

# Normalize a title

`POST /versions/{version}/normalize`

Normalize a raw job title string to the best matching Lightcast title.

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

Raw title size is limited to 1kB.

Note that this endpoint has a base tier yearly quota of 50 requests. [Contact us](https://docs.lightcast.dev/contact) if you'd like this increased or made unlimited. Responses from this endpoint will include two headers, `RateLimit-Remaining` and `RateLimit-Reset`, which indicate how many requests you have remaining in your current quota period and when that quota will reset, respectively.

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

## Query parameters

- `confidenceThreshold` number
- `fields` string

## Request body

- object
  - `term` string, required
  - `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
    - `confidence` number, required
    - `jobLevels` 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)