---
title: "/job_title/enrich"
method: POST
path: "/v5/job_title/enrich"
tags: ["Job Title Enrichment"]
---

# /job_title/enrich

`POST /v5/job_title/enrich`

## Request

- Base URL: `https://api.peopledatalabs.com`
- URL: `https://api.peopledatalabs.com/v5/job_title/enrich`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/docs/v5/job_title/enrich/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `job_title` string: Job title that will be enriched
  - `titlecase` boolean: Setting titlecase to true will titlecase any records returned
  - `pretty` boolean: Whether the output should have human-readable indentation

## Response `200`

Job Title enrich completed.

- JobTitle
  - `cleaned_job_title` string: The job title that matches the API input job_title after passing it through our internal job title cleaner.
  - `similar_job_titles` string[]: A list of up to five of the most contextually-similar job titles to the cleaned_job_title, determined using our global resume data.
  - `relevant_skills:` string[]: A list of up to five of the most contextually-similar skills to the cleaned_job_title, determined using our global resume data.

## Other responses

- `400`: Request contained either missing or invalid parameters
- `401`: Request contained a missing or invalid key
- `402`: You have reached your account maximum (all matches used)
- `404`: No records were found matching your request
- `405`: Request method is not allowed on the requested resource
- `429`: An error occurred due to requests hitting the API too quickly

## Changes

- **2024-08-27** `d6cfb6a2a978`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/changes/v5/job_title/enrich/post.md)

---

[API](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com.md) - [All operations](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/llms.txt) - [OpenAPI document](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/revisions/c75f23548f5b?raw)