Titles API

v1.12.2

Information on past releases can be found in the Changelog.

Note: By default, all clients are allowed a maximum of 5 requests per second. Contact us here if you need an adjustment.

Overview

Lightcast Titles is a comprehensive library of job titles defined by Lightcast.

This API exposes the complete collection of Lightcast titles which includes normalization functionality to transform raw job titles to Lightcast titles and curated occupation and skill mappings for each title.

About Data

Job Title Mappings

Mappings connect each Lightcast job title to a combination of SOCs and Skills. This combination can be thought of as a description of what the title represents. The skills for this mapping don’t necessarily reflect a comprehensive list but are rather skills considered significant for that title. These are usually skills that can be found in the title or are distinguishing.

Please note that Job Title mappings no longer have names associated with them, for structural reasons the field remains but it will always be empty.

Example Job Title mapping

{
    "name": "",
    "skills": [
        {
            "id": "KS121846ZPGFX2YXB1KN",
            "name": "Burn Care"
        },
        {
            "id": "KS442546YGKQC49SH18W",
            "name": "Wound Care"
        }
    ],
    "socs": [
        {
            "id": "29-1141",
            "name": "Registered Nurses"
        }
    ]
}

Content type

Unless otherwise noted, all requests that require a body accept application/json. Likewise, all response bodies are application/json.

Quotas:

By default all clients have rate limiting of 5 requests per second and specific endpoint quotas of 50 requests per year, their rate-limit and quota can be changed through Authentication claims (see below). For more detail on the quota system see our Authentication Quota document.

A client's rate-limit (default 5 per second) can be changed through a titles:rate-limit Authentication claim. To increase a client's limit to 20 per second use titles:rate-limit:20/1 and to grant them unlimited access use titles:rate-limit:unlimited

/versions/{verison}/normalize /versions/{version}/normalize/inspect /versions/{version}/normalize/bulk

A client's normalize quota can be changed through a titles:normalize:quota Authentication claim. To increase a client's monthly quota to 100 per month use titles:normalize:quota:100/month, to grant them unlimited access use titles:normalize:quota:unlimited.

Access Claims:

titles:full_access

Grants access to /versions/{verison}/normalize
Grants access to mapping field in each endpoint

titles:normalize:bulk

Grants access to /versions/{version}/normalize/bulk

/status

Health check endpoint

`GET` Get service status

Get the health of the service. Be sure to check the healthy attribute of the response, not just the status code. Caching not recommended.

Code Examples

{
  "method": "GET",
  "url": "https://emsiservices.com/titles/status",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    }
  ],
  "queryString": []
}

Response Examples

{
  "data": {
    "message": "Service is healthy",
    "healthy": true
  }
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/status.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Status response object",
            "type": "object",
            "properties": {
                "message": {
                    "title": "Message describing the health of the service",
                    "type": "string",
                    "minLength": 1
                },
                "healthy": {
                    "title": "Boolean value to show if the service is healthy",
                    "type": "boolean"
                }
            },
            "required": [
                "message",
                "healthy"
            ],
            "additionalProperties": false
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

/meta

Get info on latest version, and attribution text.

`GET` Get service metadata

Get service metadata, including latest version, and attribution text. Caching is encouraged, but the metadata can change weekly.

Code Examples

{
  "method": "GET",
  "url": "https://emsiservices.com/titles/meta",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    }
  ],
  "queryString": []
}

Response Examples

{
  "data": {
    "attribution": {
      "title": "Lightcast Titles",
      "body": "Lightcast Titles is a comprehensive library of job titles defined by Lightcast."
    },
    "latestVersion": "4.30"
  }
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "type": "object",
    "$id": "responses/meta.schema.json",
    "properties": {
        "data": {
            "title": "Meta response object",
            "type": "object",
            "properties": {
                "attribution": {
                    "title": "Service attribution object",
                    "type": "object",
                    "properties": {
                        "title": {
                            "title": "Name of the service",
                            "type": "string",
                            "minLength": 1
                        },
                        "body": {
                            "title": "Service description",
                            "type": "string",
                            "minLength": 1
                        }
                    },
                    "required": [
                        "title",
                        "body"
                    ],
                    "additionalProperties": false
                },
                "latestVersion": {
                    "title": "Latest title version available in the service",
                    "type": "string",
                    "minLength": 1
                }
            },
            "required": [
                "attribution",
                "latestVersion"
            ],
            "additionalProperties": false
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

/versions

A list of available title versions

`GET` List all versions

Version latest can be used as an alias to the latest title version. See our Titles Taxonomy Changelog for version updates.

Code Examples

{
  "method": "GET",
  "url": "https://emsiservices.com/titles/versions",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    }
  ],
  "queryString": []
}

Response Examples

{
  "data": [
    "4.30",
    "4.29",
    "4.28",
    "4.27",
    "4.26",
    "4.25",
    "4.24",
    "4.23",
    "4.22",
    "4.21",
    "4.20",
    "4.19",
    "4.18",
    "4.17",
    "4.16",
    "4.15",
    "4.14",
    "4.13",
    "4.12",
    "4.11",
    "4.10",
    "4.9",
    "4.8",
    "4.7",
    "4.6",
    "4.5",
    "4.4",
    "4.3",
    "4.2",
    "4.1"
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/versions.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "List of available title versions",
            "type": "array",
            "items": {
                "type": "string",
                "__nodocs": true
            },
            "minItems": 1
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

/versions/{version}

Version specific metadata

`GET` Get version metadata

Get version specific metadata including available fields, data versions, title counts and removed title counts.

URL Parameters

Name	Description
versionstring	The title version.Example: `latest`

Code Examples

{
  "method": "GET",
  "url": "https://emsiservices.com/titles/versions/latest",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    }
  ],
  "queryString": []
}

Response Examples

{
  "data": {
    "version": "4.30",
    "fields": [
      "id",
      "name",
      "pluralName",
      "isSupervisor",
      "levelBand",
      "mapping"
    ],
    "mappingVersions": {
      "soc": [
        "soc_emsi_2019"
      ],
      "skill": [
        "7.34"
      ]
    },
    "titleCount": 72859,
    "removedTitleCount": 3438
  }
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/version-meta.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Version specific meta data object",
            "type": "object",
            "properties": {
                "version": {
                    "title": "Title version number",
                    "type": "string",
                    "minLength": 1
                },
                "titleCount": {
                    "title": "Total number of available titles",
                    "type": "integer",
                    "minimum": 0
                },
                "removedTitleCount": {
                    "title": "Total number of removed titles",
                    "type": "integer",
                    "minimum": 0
                },
                "mappingVersions": {
                    "title": "Skills and SOC codes mapping for titles",
                    "type": "object",
                    "properties": {
                        "soc": {
                            "title": "Available SOC code version for mapping",
                            "type": "array",
                            "items": {
                                "type": "string",
                                "minLength": 1,
                                "__nodocs": true
                            },
                            "minItems": 1
                        },
                        "skill": {
                            "title": "Available skill version for mapping",
                            "type": "array",
                            "items": {
                                "type": "string",
                                "minLength": 1,
                                "__nodocs": true
                            },
                            "minItems": 1
                        }
                    },
                    "required": [
                        "soc",
                        "skill"
                    ],
                    "additionalProperties": false
                },
                "fields": {
                    "title": "List of available values for fields query parameter",
                    "type": "array",
                    "items": {
                        "type": "string",
                        "minLength": 1,
                        "__nodocs": true
                    },
                    "minItems": 1
                }
            },
            "required": [
                "version",
                "titleCount",
                "removedTitleCount",
                "fields"
            ],
            "additionalProperties": false
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

/versions/{version}/changes

Version specific changes

`GET` Get version changes

Get version specific changes.

URL Parameters

Name	Description
versionstring	The titles taxonomy version.Example: `latest`

Code Examples

{
  "method": "GET",
  "url": "https://emsiservices.com/titles/versions/latest/changes",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    }
  ],
  "queryString": []
}

Response Examples

{
  "data": {
    "additions": [
      {
        "id": "ET72E64338B77E4585",
        "title": "Stock Taker"
      }
    ],
    "removals": [
      {
        "id": "ET4184BC17C5F67F27",
        "title": "PM Manager"
      }
    ],
    "alterations": [
      {
        "id": "ETCD7750DD30D06DBE",
        "title": "Crater"
      }
    ]
  }
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/changes.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Categorized title version changes",
            "type": "object",
            "properties": {
                "additions": {
                    "title": "List of newly added titles",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "title": {
                                "title": "New title name",
                                "type": "string",
                                "minLength": 1
                            },
                            "id": {
                                "title": "New title id",
                                "type": "string",
                                "minLength": 1
                            }
                        },
                        "required": [
                            "title",
                            "id"
                        ],
                        "additionalProperties": false
                    },
                    "minItems": 0
                },
                "removals": {
                    "title": "List of removed titles",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "title": {
                                "title": "Removed title name",
                                "type": "string",
                                "minLength": 1
                            },
                            "id": {
                                "title": "Removed title id",
                                "type": "string",
                                "minLength": 1
                            }
                        },
                        "required": [
                            "title",
                            "id"
                        ],
                        "additionalProperties": false
                    },
                    "minItems": 0
                },
                "alterations": {
                    "title": "List of altered titles",
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "title": {
                                "title": "title name",
                                "type": "string",
                                "minLength": 1
                            },
                            "id": {
                                "title": "title id",
                                "type": "string",
                                "minLength": 1
                            }
                        },
                        "required": [
                            "title",
                            "id"
                        ],
                        "additionalProperties": false
                    },
                    "minItems": 0
                }
            }
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

/versions/{version}/titles

Returns a list of all titles in {version} sorted by title name

`GET` List all titles

Requesting title mappings requires additional permissions, please contact us if you'd like access to mappings.

URL Parameters

Name	Description
versionstring	The title version.Example: `latest`

Query Parameters

Name	Description
qstring	A query string of title names to search for.This parameter is optional.Example: `.NET`
fieldsstring	List of fields to return per title. See /versions/{version} for available fields. Mappings require additional permissions, please contact us if you'd like access to mappings.This parameter is optional.Default: `id,name`
limitinteger	Limit the number of titles returned in the response.This parameter is optional.Example: `5`
pageinteger	Paginate the response and choose which page to return.This parameter is optional.Example: `2`

Code Examples

{
  "method": "GET",
  "url": "https://emsiservices.com/titles/versions/latest/titles",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    }
  ],
  "queryString": [
    {
      "name": "q",
      "value": ".NET"
    },
    {
      "name": "limit",
      "value": "5"
    },
    {
      "name": "page",
      "value": "2"
    }
  ]
}

Response Examples

{
  "data": [
    {
      "id": "ETB9638ED17EEBE37D",
      "name": "Networker"
    },
    {
      "id": "ETAC9C14767C0F125C",
      "name": "Network Engineer/Network Administrator"
    },
    {
      "id": "ET02716A0AE13432E8",
      "name": "Networking Technician"
    },
    {
      "id": "ET057AF8DAB081D057",
      "name": "Network Designer"
    },
    {
      "id": "ET06255061AE3134B8",
      "name": "Network Lead"
    }
  ]
}

Invalid request.

{
  "errors": [
    {
      "status": 400,
      "title": "Invalid request",
      "detail": "Invalid request body"
    }
  ]
}

You don't have access to the normalization endpoint.

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized",
      "detail": "You do not have access to this endpoint, please contact us at 'apisupport@emsibg.com' to request access."
    }
  ]
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/titles.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Title search response object",
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "title": "Title id",
                        "type": "string",
                        "minLength": 1
                    },
                    "name": {
                        "title": "Title name",
                        "type": "string",
                        "minLength": 1
                    },
                    "pluralName": {
                        "title": "Plural form of title name",
                        "type": "string",
                        "minLength": 1
                    },
                    "mapping": {
                        "title": "Title SOC and skill mappings",
                        "type": "object",
                        "properties": {
                            "names": {
                                "title": "List of mapping names",
                                "description": "Mapping names are included in Titles v4.6 and onward.\n\nTitles 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.",
                                "type": "array",
                                "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "__nodocs": true
                                }
                            },
                            "socs": {
                                "title": "List of SOC mappings",
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "title": "SOC code",
                                            "type": "string",
                                            "minLength": 1
                                        },
                                        "name": {
                                            "title": "SOC name",
                                            "type": "string",
                                            "minLength": 1
                                        }
                                    },
                                    "required": [
                                        "id",
                                        "name"
                                    ],
                                    "additionalProperties": false
                                }
                            },
                            "skills": {
                                "title": "List of skill mappings",
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "title": "Skill id",
                                            "type": "string",
                                            "minLength": 1
                                        },
                                        "name": {
                                            "title": "Skill name",
                                            "type": "string",
                                            "minLength": 1
                                        }
                                    },
                                    "required": [
                                        "id",
                                        "name"
                                    ],
                                    "additionalProperties": false
                                }
                            }
                        },
                        "required": [
                            "socs",
                            "skills",
                            "names"
                        ],
                        "additionalProperties": false
                    },
                    "isSupervisor": {
                        "title": "Boolean value indicating whether the title's role is supervisory",
                        "type": "boolean",
                        "__internal": true
                    },
                    "levelBand": {
                        "title": "Standardized job level category",
                        "type": [
                            "string",
                            "null"
                        ],
                        "minLength": 1,
                        "__internal": true
                    },
                    "infoUrl": {
                        "title": "URL for a publicly accessible web page that includes information about the title",
                        "type": [
                            "string",
                            "null"
                        ],
                        "minLength": 1,
                        "pattern": "https://lightcast.io/open-titles/titles/.+"
                    }
                }
            }
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

`POST` List requested titles

Requesting title mappings requires additional permissions, please contact us if you'd like access to mappings.

URL Parameters

Name	Description
versionstring	The title version.Example: `latest`

Request Body

{
  "ids": [
    "ET89954A897A9A69C4",
    "ET3B93055220D592C8",
    "ET28D75166A2288ED3"
  ],
  "fields": [
    "id",
    "name",
    "pluralName"
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "requests/titles-lookup.schema.json",
    "type": "object",
    "properties": {
        "ids": {
            "title": "Title ids",
            "type": "array",
            "items": {
                "type": "string",
                "minLength": 1,
                "__nodocs": true
            },
            "minItems": 1
        },
        "fields": {
            "title": "List of fields to return per title",
            "description": "See [/versions/{version}](#versions-version) for available fields.\n\n`mappings` require additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to mappings.",
            "type": "array",
            "items": {
                "type": "string",
                "minLength": 1,
                "__nodocs": true
            },
            "minItems": 1,
            "default": [
                "id",
                "name"
            ]
        }
    },
    "required": [
        "ids"
    ],
    "additionalProperties": false
}

Code Examples

{
  "method": "POST",
  "url": "https://emsiservices.com/titles/versions/latest/titles",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    },
    {
      "name": "Content-Type",
      "value": "application/json"
    }
  ],
  "postData": {
    "mimeType": "application/json",
    "text": "{ \"ids\": [ \"ET89954A897A9A69C4\", \"ET3B93055220D592C8\", \"ET28D75166A2288ED3\" ], \"fields\": [ \"id\", \"name\", \"pluralName\" ] }"
  },
  "queryString": []
}

Response Examples

{
  "data": [
    {
      "id": "ET89954A897A9A69C4",
      "pluralName": "Computer Scientists",
      "name": "Computer Scientist"
    },
    {
      "id": "ET3B93055220D592C8",
      "pluralName": "Data Scientists",
      "name": "Data Scientist"
    },
    {
      "id": "ET28D75166A2288ED3",
      "pluralName": "Scientists",
      "name": "Scientist"
    }
  ]
}

Invalid request.

{
  "errors": [
    {
      "status": 400,
      "title": "Invalid request",
      "detail": "Invalid request body"
    }
  ]
}

You don't have access to the normalization endpoint.

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized",
      "detail": "You do not have access to this endpoint, please contact us at 'apisupport@emsibg.com' to request access."
    }
  ]
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/titles.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Title search response object",
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "id": {
                        "title": "Title id",
                        "type": "string",
                        "minLength": 1
                    },
                    "name": {
                        "title": "Title name",
                        "type": "string",
                        "minLength": 1
                    },
                    "pluralName": {
                        "title": "Plural form of title name",
                        "type": "string",
                        "minLength": 1
                    },
                    "mapping": {
                        "title": "Title SOC and skill mappings",
                        "type": "object",
                        "properties": {
                            "names": {
                                "title": "List of mapping names",
                                "description": "Mapping names are included in Titles v4.6 and onward.\n\nTitles 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.",
                                "type": "array",
                                "items": {
                                    "type": "string",
                                    "minLength": 1,
                                    "__nodocs": true
                                }
                            },
                            "socs": {
                                "title": "List of SOC mappings",
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "title": "SOC code",
                                            "type": "string",
                                            "minLength": 1
                                        },
                                        "name": {
                                            "title": "SOC name",
                                            "type": "string",
                                            "minLength": 1
                                        }
                                    },
                                    "required": [
                                        "id",
                                        "name"
                                    ],
                                    "additionalProperties": false
                                }
                            },
                            "skills": {
                                "title": "List of skill mappings",
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "id": {
                                            "title": "Skill id",
                                            "type": "string",
                                            "minLength": 1
                                        },
                                        "name": {
                                            "title": "Skill name",
                                            "type": "string",
                                            "minLength": 1
                                        }
                                    },
                                    "required": [
                                        "id",
                                        "name"
                                    ],
                                    "additionalProperties": false
                                }
                            }
                        },
                        "required": [
                            "socs",
                            "skills",
                            "names"
                        ],
                        "additionalProperties": false
                    },
                    "isSupervisor": {
                        "title": "Boolean value indicating whether the title's role is supervisory",
                        "type": "boolean",
                        "__internal": true
                    },
                    "levelBand": {
                        "title": "Standardized job level category",
                        "type": [
                            "string",
                            "null"
                        ],
                        "minLength": 1,
                        "__internal": true
                    },
                    "infoUrl": {
                        "title": "URL for a publicly accessible web page that includes information about the title",
                        "type": [
                            "string",
                            "null"
                        ],
                        "minLength": 1,
                        "pattern": "https://lightcast.io/open-titles/titles/.+"
                    }
                }
            }
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

/versions/{version}/titles/{titleId}

Returns information about a specific title

`GET` Get a title by ID

Requesting title mappings requires additional permissions, please contact us if you'd like access to mappings.

URL Parameters

Name	Description
versionstring	The title version.Example: `latest`
titleIdstring	Title id.Example: `ET89954A897A9A69C4`

Code Examples

{
  "method": "GET",
  "url": "https://emsiservices.com/titles/versions/latest/titles/ET89954A897A9A69C4",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    }
  ],
  "queryString": []
}

Response Examples

{
  "data": {
    "id": "ET89954A897A9A69C4",
    "name": "Computer Scientist",
    "pluralName": "Computer Scientists",
    "isSupervisor": false,
    "levelBand": "Professional",
    "mapping": {
      "names": [],
      "skills": [],
      "socs": [
        {
          "id": "15-1221",
          "name": "Computer and Information Research Scientists"
        }
      ]
    },
    "infoUrl": "https://lightcast.io/open-titles/titles/ET35635562C89DD29C",
    "removedVersion": null,
    "addedVersion": "1"
  }
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/single-title-search.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Single title search response object",
            "type": "object",
            "properties": {
                "id": {
                    "title": "Title id",
                    "type": "string",
                    "minLength": 1
                },
                "name": {
                    "title": "Title name",
                    "type": "string",
                    "minLength": 1
                },
                "pluralName": {
                    "title": "Plural form of title name",
                    "type": "string",
                    "minLength": 1
                },
                "mapping": {
                    "title": "Title SOC and skill mappings",
                    "type": "object",
                    "properties": {
                        "names": {
                            "title": "List of mapping names",
                            "description": "Mapping names are included in Titles v4.6 and onward.\n\nTitles 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.",
                            "type": "array",
                            "items": {
                                "type": "string",
                                "minLength": 1,
                                "__nodocs": true
                            }
                        },
                        "socs": {
                            "title": "List of SOC mappings",
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "title": "SOC code",
                                        "type": "string",
                                        "minLength": 1
                                    },
                                    "name": {
                                        "title": "SOC name",
                                        "type": "string",
                                        "minLength": 1
                                    }
                                },
                                "required": [
                                    "id",
                                    "name"
                                ],
                                "additionalProperties": false
                            }
                        },
                        "skills": {
                            "title": "List of skill mappings",
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "id": {
                                        "title": "Skill id",
                                        "type": "string",
                                        "minLength": 1
                                    },
                                    "name": {
                                        "title": "Skill name",
                                        "type": "string",
                                        "minLength": 1
                                    }
                                },
                                "required": [
                                    "id",
                                    "name"
                                ],
                                "additionalProperties": false
                            }
                        }
                    },
                    "required": [
                        "socs",
                        "skills",
                        "names"
                    ],
                    "additionalProperties": false
                },
                "isSupervisor": {
                    "title": "Boolean value indicating whether the title's role is supervisory",
                    "type": "boolean",
                    "__internal": true
                },
                "levelBand": {
                    "title": "Standardized job level category",
                    "type": [
                        "string",
                        "null"
                    ],
                    "minLength": 1,
                    "__internal": true
                },
                "infoUrl": {
                    "title": "URL for a publicly accessible web page that includes information about the title",
                    "type": [
                        "string",
                        "null"
                    ],
                    "minLength": 1,
                    "pattern": "https://lightcast.io/open-titles/titles/.+"
                },
                "removedVersion": {
                    "title": "Version when the title was removed",
                    "description": "`null` if the title has not been removed.",
                    "type": [
                        "string",
                        "null"
                    ]
                },
                "addedVersion": {
                    "title": "Version when the title was added",
                    "type": "string"
                }
            },
            "required": [
                "id",
                "name",
                "pluralName",
                "isSupervisor",
                "levelBand",
                "infoUrl",
                "removedVersion",
                "addedVersion"
            ],
            "additionalProperties": false
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

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

`POST` Normalize a title

This endpoint requires additional permissions, please contact us if you'd like access to normalization.

URL Parameters

Name	Description
versionstring	The title version.Example: `latest`

Query Parameters

Name	Description
confidenceThresholdnumber	Filter out titles with a confidence value lower than this threshold (this query param does not apply for JSON requests).Minimum: `0`Maximum: `1`Default: `0.5`
fieldsstring	List of fields to return per title. See /versions/{version} for available fields (this query param does not apply for JSON requests).This parameter is optional.Default: `id,name`

Request Body

{
  "term": "data scientist"
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "requests/normalize.schema.json",
    "type": "object",
    "properties": {
        "term": {
            "title": "Title name",
            "type": "string",
            "minLength": 1
        },
        "fields": {
            "title": "List of fields to return per title",
            "description": "See [/versions/{version}](#versions-version) for available fields.\n\n`mappings` require additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to mappings.",
            "type": "array",
            "items": {
                "type": "string",
                "minLength": 1,
                "__nodocs": true
            },
            "minItems": 1,
            "default": [
                "id",
                "name"
            ]
        },
        "confidenceThreshold": {
            "title": "Filter out normalized titles with a confidence value lower than this threshold",
            "type": "number",
            "default": 0.5,
            "minimum": 0,
            "maximum": 1
        }
    },
    "required": [
        "term"
    ],
    "additionalProperties": false
}

Code Examples

{
  "method": "POST",
  "url": "https://emsiservices.com/titles/versions/latest/normalize",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    },
    {
      "name": "Content-Type",
      "value": "application/json"
    }
  ],
  "postData": {
    "mimeType": "application/json",
    "text": "{ \"term\": \"data scientist\" }"
  },
  "queryString": []
}

Response Examples

{
  "data": {
    "confidence": 1,
    "jobLevels": [],
    "title": {
      "id": "ET3B93055220D592C8",
      "name": "Data Scientist"
    }
  }
}

Invalid request.

{
  "errors": [
    {
      "status": 400,
      "title": "Invalid request",
      "detail": "Invalid request body"
    }
  ]
}

You don't have access to the normalization endpoint.

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized",
      "detail": "You do not have access to this endpoint, please contact us at 'apisupport@emsibg.com' to request access."
    }
  ]
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

Request size too large.

{
  "errors": [
    {
      "detail": "Request size too large",
      "status": 413,
      "title": "Payload Too Large"
    }
  ]
}

Unsupported Content Type.

{
  "errors": [
    {
      "detail": "Accepted Content-Type(s): 'application/json', 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'",
      "status": 415,
      "title": "Unsupported Content Type"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/normalize.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Title normalize response object",
            "type": "object",
            "properties": {
                "title": {
                    "title": "Normalized title",
                    "type": "object",
                    "properties": {
                        "id": {
                            "title": "Title id",
                            "type": "string",
                            "minLength": 1
                        },
                        "name": {
                            "title": "Title name",
                            "type": "string",
                            "minLength": 1
                        },
                        "pluralName": {
                            "title": "Plural form of title name",
                            "type": "string",
                            "minLength": 1
                        },
                        "mapping": {
                            "title": "Title SOC and skill mappings",
                            "type": "object",
                            "properties": {
                                "names": {
                                    "title": "List of mapping names",
                                    "description": "Mapping names are included in Titles v4.6 and onward.\n\nTitles 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.",
                                    "type": "array",
                                    "items": {
                                        "type": "string",
                                        "minLength": 1,
                                        "__nodocs": true
                                    }
                                },
                                "socs": {
                                    "title": "List of SOC mappings",
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "title": "SOC code",
                                                "type": "string",
                                                "minLength": 1
                                            },
                                            "name": {
                                                "title": "SOC name",
                                                "type": "string",
                                                "minLength": 1
                                            }
                                        },
                                        "required": [
                                            "id",
                                            "name"
                                        ],
                                        "additionalProperties": false
                                    }
                                },
                                "skills": {
                                    "title": "List of skill mappings",
                                    "type": "array",
                                    "items": {
                                        "type": "object",
                                        "properties": {
                                            "id": {
                                                "title": "Skill id",
                                                "type": "string",
                                                "minLength": 1
                                            },
                                            "name": {
                                                "title": "Skill name",
                                                "type": "string",
                                                "minLength": 1
                                            }
                                        },
                                        "required": [
                                            "id",
                                            "name"
                                        ],
                                        "additionalProperties": false
                                    }
                                }
                            },
                            "required": [
                                "socs",
                                "skills",
                                "names"
                            ],
                            "additionalProperties": false
                        },
                        "isSupervisor": {
                            "title": "Boolean value indicating whether the title's role is supervisory",
                            "type": "boolean",
                            "__internal": true
                        },
                        "levelBand": {
                            "title": "Standardized job level category",
                            "type": [
                                "string",
                                "null"
                            ],
                            "minLength": 1,
                            "__internal": true
                        },
                        "infoUrl": {
                            "title": "URL for a publicly accessible web page that includes information about the title",
                            "type": [
                                "string",
                                "null"
                            ],
                            "minLength": 1,
                            "pattern": "https://lightcast.io/open-titles/titles/.+"
                        }
                    },
                    "additionalProperties": false
                },
                "confidence": {
                    "title": "A number between 0 and 1 representing the confidence of the title normalization",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                },
                "jobLevels": {
                    "title": "List of normalized job seniority information",
                    "type": "array",
                    "items": {
                        "type": "string",
                        "minLength": 1,
                        "__nodocs": true
                    }
                }
            },
            "required": [
                "title",
                "confidence",
                "jobLevels"
            ],
            "additionalProperties": false
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

/versions/{version}/normalize/inspect

Normalize a raw job title string to a list of the top matching Lightcast titles

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

`POST` Inspect title normalization

Requesting title mappings requires additional permissions, please contact us if you'd like access to mappings.

URL Parameters

Name	Description
versionstring	The title version.Example: `latest`

Query Parameters

Name	Description
confidenceThresholdnumber	Filter out titles with a confidence value lower than this threshold (this query param does not apply for JSON requests).Minimum: `0`Maximum: `1`Default: `0.5`
limitinteger	Limit the number of normalized titles for the given term (this query param does not apply for JSON requests).Minimum: `0`Maximum: `100`Default: `5`
fieldsstring	List of fields to return per title. See /versions/{version} for available fields (this query param does not apply for JSON requests). Mappings require additional permissions, please contact us if you'd like access to mappings.This parameter is optional.Default: `id,name`

Request Body

{
  "term": "data scientist",
  "limit": 2
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "requests/inspect-normalize.schema.json",
    "type": "object",
    "properties": {
        "term": {
            "title": "Title name",
            "type": "string",
            "minLength": 1
        },
        "fields": {
            "title": "List of fields to return per title",
            "description": "See [/versions/{version}](#versions-version) for available fields.\n\n`mappings` require additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to mappings.",
            "type": "array",
            "items": {
                "type": "string",
                "minLength": 1,
                "__nodocs": true
            },
            "minItems": 1,
            "default": [
                "id",
                "name"
            ]
        },
        "confidenceThreshold": {
            "title": "Filter out normalized titles with a confidence value lower than this threshold",
            "type": "number",
            "default": 0.5,
            "minimum": 0,
            "maximum": 1
        },
        "limit": {
            "title": "Limit the number of normalized titles for the given term",
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "default": 5
        }
    },
    "required": [
        "term"
    ],
    "additionalProperties": false
}

Code Examples

{
  "method": "POST",
  "url": "https://emsiservices.com/titles/versions/latest/normalize/inspect",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    },
    {
      "name": "Content-Type",
      "value": "application/json"
    }
  ],
  "postData": {
    "mimeType": "application/json",
    "text": "{ \"term\": \"data scientist\", \"limit\": 2 }"
  },
  "queryString": []
}

Response Examples

{
  "data": [
    {
      "confidence": 1,
      "jobLevels": [],
      "title": {
        "id": "ET3B93055220D592C8",
        "name": "Data Scientist"
      }
    },
    {
      "confidence": 0.8584786653518677,
      "jobLevels": [],
      "title": {
        "id": "ET66EFA7BC3A32BB32",
        "name": "Manager/Data Scientist"
      }
    }
  ]
}

Invalid request.

{
  "errors": [
    {
      "status": 400,
      "title": "Invalid request",
      "detail": "Invalid request body"
    }
  ]
}

You don't have access to the normalization endpoint.

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized",
      "detail": "You do not have access to this endpoint, please contact us at 'apisupport@emsibg.com' to request access."
    }
  ]
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

Request size too large.

{
  "errors": [
    {
      "detail": "Request size too large",
      "status": 413,
      "title": "Payload Too Large"
    }
  ]
}

Unsupported Content Type.

{
  "errors": [
    {
      "detail": "Accepted Content-Type(s): 'application/json', 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'",
      "status": 415,
      "title": "Unsupported Content Type"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/inspect-normalize.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "Title normalize response object",
            "type": "array",
            "items": {
                "title": "Title normalize response object",
                "type": "object",
                "properties": {
                    "title": {
                        "title": "Normalized title",
                        "type": "object",
                        "properties": {
                            "id": {
                                "title": "Title id",
                                "type": "string",
                                "minLength": 1
                            },
                            "name": {
                                "title": "Title name",
                                "type": "string",
                                "minLength": 1
                            },
                            "pluralName": {
                                "title": "Plural form of title name",
                                "type": "string",
                                "minLength": 1
                            },
                            "mapping": {
                                "title": "Title SOC and skill mappings",
                                "type": "object",
                                "properties": {
                                    "names": {
                                        "title": "List of mapping names",
                                        "description": "Mapping names are included in Titles v4.6 and onward.\n\nTitles 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.",
                                        "type": "array",
                                        "items": {
                                            "type": "string",
                                            "minLength": 1,
                                            "__nodocs": true
                                        }
                                    },
                                    "socs": {
                                        "title": "List of SOC mappings",
                                        "type": "array",
                                        "items": {
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "title": "SOC code",
                                                    "type": "string",
                                                    "minLength": 1
                                                },
                                                "name": {
                                                    "title": "SOC name",
                                                    "type": "string",
                                                    "minLength": 1
                                                }
                                            },
                                            "required": [
                                                "id",
                                                "name"
                                            ],
                                            "additionalProperties": false
                                        }
                                    },
                                    "skills": {
                                        "title": "List of skill mappings",
                                        "type": "array",
                                        "items": {
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "title": "Skill id",
                                                    "type": "string",
                                                    "minLength": 1
                                                },
                                                "name": {
                                                    "title": "Skill name",
                                                    "type": "string",
                                                    "minLength": 1
                                                }
                                            },
                                            "required": [
                                                "id",
                                                "name"
                                            ],
                                            "additionalProperties": false
                                        }
                                    }
                                },
                                "required": [
                                    "socs",
                                    "skills",
                                    "names"
                                ],
                                "additionalProperties": false
                            },
                            "isSupervisor": {
                                "title": "Boolean value indicating whether the title's role is supervisory",
                                "type": "boolean",
                                "__internal": true
                            },
                            "levelBand": {
                                "title": "Standardized job level category",
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "minLength": 1,
                                "__internal": true
                            },
                            "infoUrl": {
                                "title": "URL for a publicly accessible web page that includes information about the title",
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "minLength": 1,
                                "pattern": "https://lightcast.io/open-titles/titles/.+"
                            }
                        },
                        "additionalProperties": false
                    },
                    "confidence": {
                        "title": "A number between 0 and 1 representing the confidence of the title normalization",
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                    },
                    "jobLevels": {
                        "title": "List of normalized job seniority information",
                        "type": "array",
                        "items": {
                            "type": "string",
                            "minLength": 1,
                            "__nodocs": true
                        }
                    }
                },
                "required": [
                    "title",
                    "confidence",
                    "jobLevels"
                ],
                "additionalProperties": false
            }
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}

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

`POST` Normalize titles in bulk

This endpoint requires additional permissions, please contact us if you'd like access to bulk normalization. Requesting title mappings requires additional permissions, please contact us if you'd like access to mappings.

URL Parameters

Name	Description
versionstring	The title version.Example: `latest`

Query Parameters

Name	Description
confidenceThresholdnumber	Filter out titles with a confidence value lower than this threshold (this query param does not apply for JSON requests).Minimum: `0`Maximum: `1`Default: `0.5`
fieldsstring	List of fields to return per title. See /versions/{version} for available fields (this query param does not apply for JSON requests).This parameter is optional.Default: `id,name`

Request Body

{
  "terms": [
    "data scientist",
    "software engineer"
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "requests/bulk-normalize.schema.json",
    "type": "object",
    "properties": {
        "terms": {
            "title": "List of terms to normalize",
            "description": "Maximum number of terms: `500`",
            "type": "array",
            "items": {
                "title": "Title name",
                "type": "string",
                "minLength": 1
            },
            "minItems": 1
        },
        "fields": {
            "title": "List of fields to return per title",
            "description": "See [/versions/{version}](#versions-version) for available fields.\n\n`mappings` require additional permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to mappings.",
            "type": "array",
            "items": {
                "type": "string",
                "minLength": 1,
                "__nodocs": true
            },
            "minItems": 1,
            "default": [
                "id",
                "name"
            ]
        },
        "confidenceThreshold": {
            "title": "Filter out normalized titles with a confidence value lower than this threshold",
            "type": "number",
            "default": 0.5,
            "minimum": 0,
            "maximum": 1
        }
    },
    "required": [
        "terms"
    ],
    "additionalProperties": false
}

Code Examples

{
  "method": "POST",
  "url": "https://emsiservices.com/titles/versions/latest/normalize/bulk",
  "show": true,
  "headers": [
    {
      "name": "Authorization",
      "value": "Bearer "
    },
    {
      "name": "Content-Type",
      "value": "application/json"
    }
  ],
  "postData": {
    "mimeType": "application/json",
    "text": "{ \"terms\": [ \"data scientist\", \"software engineer\" ] }"
  },
  "queryString": []
}

Response Examples

{
  "data": [
    {
      "confidence": 1,
      "term": "data scientist",
      "jobLevels": [],
      "title": {
        "id": "ET3B93055220D592C8",
        "name": "Data Scientist"
      }
    },
    {
      "confidence": 1,
      "term": "software engineer",
      "jobLevels": [],
      "title": {
        "id": "ET6850661D6AE5FA86",
        "name": "Software Engineer"
      }
    }
  ]
}

Invalid request.

{
  "errors": [
    {
      "status": 400,
      "title": "Invalid request",
      "detail": "Invalid request body"
    }
  ]
}

You don't have access to bulk normalize endpoint.

{
  "errors": [
    {
      "status": 401,
      "title": "Unauthorized",
      "detail": "You do not have access to this endpoint, please contact us at 'apisupport@emsibg.com' to request access."
    }
  ]
}

The version you requested wasn't found.

{
  "errors": [
    {
      "title": "URL not found",
      "status": 404,
      "detail": "Unrecognized version: invaildVersion"
    }
  ]
}

Request size too large.

{
  "errors": [
    {
      "detail": "Request size too large",
      "status": 413,
      "title": "Payload Too Large"
    }
  ]
}

Unsupported Content Type.

{
  "errors": [
    {
      "detail": "Accepted Content-Type(s): 'application/json', 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'",
      "status": 415,
      "title": "Unsupported Content Type"
    }
  ]
}

{
    "$schema": "http://json-schema.org/draft-07/schema",
    "$id": "responses/bulk-normalize.schema.json",
    "type": "object",
    "properties": {
        "data": {
            "title": "List of normalized object response",
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "title": {
                        "title": "Normalized title",
                        "type": "object",
                        "properties": {
                            "id": {
                                "title": "Title id",
                                "type": "string",
                                "minLength": 1
                            },
                            "name": {
                                "title": "Title name",
                                "type": "string",
                                "minLength": 1
                            },
                            "pluralName": {
                                "title": "Plural form of title name",
                                "type": "string",
                                "minLength": 1
                            },
                            "mapping": {
                                "title": "Title SOC and skill mappings",
                                "type": "object",
                                "properties": {
                                    "names": {
                                        "title": "List of mapping names",
                                        "description": "Mapping names are included in Titles v4.6 and onward.\n\nTitles 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.",
                                        "type": "array",
                                        "items": {
                                            "type": "string",
                                            "minLength": 1,
                                            "__nodocs": true
                                        }
                                    },
                                    "socs": {
                                        "title": "List of SOC mappings",
                                        "type": "array",
                                        "items": {
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "title": "SOC code",
                                                    "type": "string",
                                                    "minLength": 1
                                                },
                                                "name": {
                                                    "title": "SOC name",
                                                    "type": "string",
                                                    "minLength": 1
                                                }
                                            },
                                            "required": [
                                                "id",
                                                "name"
                                            ],
                                            "additionalProperties": false
                                        }
                                    },
                                    "skills": {
                                        "title": "List of skill mappings",
                                        "type": "array",
                                        "items": {
                                            "type": "object",
                                            "properties": {
                                                "id": {
                                                    "title": "Skill id",
                                                    "type": "string",
                                                    "minLength": 1
                                                },
                                                "name": {
                                                    "title": "Skill name",
                                                    "type": "string",
                                                    "minLength": 1
                                                }
                                            },
                                            "required": [
                                                "id",
                                                "name"
                                            ],
                                            "additionalProperties": false
                                        }
                                    }
                                },
                                "required": [
                                    "socs",
                                    "skills",
                                    "names"
                                ],
                                "additionalProperties": false
                            },
                            "isSupervisor": {
                                "title": "Boolean value indicating whether the title's role is supervisory",
                                "type": "boolean",
                                "__internal": true
                            },
                            "levelBand": {
                                "title": "Standardized job level category",
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "minLength": 1,
                                "__internal": true
                            },
                            "infoUrl": {
                                "title": "URL for a publicly accessible web page that includes information about the title",
                                "type": [
                                    "string",
                                    "null"
                                ],
                                "minLength": 1,
                                "pattern": "https://lightcast.io/open-titles/titles/.+"
                            }
                        },
                        "additionalProperties": false
                    },
                    "term": {
                        "title": "Original term of the normalized title",
                        "type": "string",
                        "minLength": 1
                    },
                    "jobLevels": {
                        "title": "List of normalized job seniority information",
                        "type": "array",
                        "items": {
                            "type": "string",
                            "minLength": 1,
                            "__nodocs": true
                        }
                    },
                    "confidence": {
                        "title": "A number between 0 and 1 representing the confidence of the title normalization",
                        "type": "number",
                        "minimum": 0,
                        "maximum": 1
                    }
                },
                "required": [
                    "title",
                    "term",
                    "jobLevels",
                    "confidence"
                ],
                "additionalProperties": false
            }
        }
    },
    "required": [
        "data"
    ],
    "additionalProperties": false
}