---
title: "Get a title by ID"
method: GET
path: "/versions/{version}/titles/{titleId}"
tags: ["Titles"]
---

# Get a title by ID

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

Returns information about a specific title.

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

OK

- object
  - `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, nullable, required
    - `infoUrl` string, nullable, required
    - `removedVersion` string, nullable, required — `null` if the title has not been removed.
    - `addedVersion` string, required

## Other responses

- `404` — requested resource not found

---

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