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

# GET /versions/{version}/titles/{titleId}

`GET /versions/{version}/titles/{titleId}`

## Request

- Base URL: `https://emsiservices.com/titles`
- URL: `https://emsiservices.com/titles/versions/{version}/titles/{titleId}`
- 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.

## Response `200`

- SingleTitleLookup
  - `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
    - `removedVersion` string, required: `null` if the title has not been removed.
    - `addedVersion` string, required

## Other responses

- `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)
