---
title: "POST /versions/{version}/titles"
method: POST
path: "/versions/{version}/titles"
---

# POST /versions/{version}/titles

`POST /versions/{version}/titles`

## Request

- Base URL: `https://emsiservices.com/titles`
- URL: `https://emsiservices.com/titles/versions/{version}/titles`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.emsicloud.com/connect/token` scopes: `emsi_open`

> 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.

## Request body

- TitlesLookupRequest
  - `ids` string[], required
  - `fields` string[]: 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.

## Response `200`

- TitlesLookupResponse
  - `data` object[], required
    - `id` string, required
    - `name` string, required
    - `pluralName` string, required
    - `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, required
    - `levelBand` string, required
    - `infoUrl` string, required

## Other responses

- `400`: Invalid request.
- `401`: You don't have access to the normalization endpoint.
- `404`: The version you requested wasn't found.

---

[API](https://skmtc.dev/lightcast/apis/titles-api.md) - [All operations](https://skmtc.dev/lightcast/apis/titles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lightcast/apis/titles-api/revisions/8bf01bb440a2?raw)