> For the complete documentation index, see [llms.txt](https://docs.sumble.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sumble.com/api/lookups/job-title-lookup.md).

# Job function & level lookup

Resolve a list of job titles to their canonical Sumble job function and level. Pass a `titles` array (1–1000 entries) and receive one entry in `results` for every input, in the same order you supplied them.

Each result pairs the original `input` title with two classifications: `job_function` and `job_level`. Either may be `null` when no confident match is available for that classification. The `job_level` includes a `level_rank` that orders levels from individual contributor to executive.

The response also returns `matched_count`, the number of titles that resolved to at least one classification.

Use this endpoint when you have a list of raw job titles and need structured, queryable identifiers — for example, to normalize titles from a CSV before passing job function or level filters to the people or jobs endpoints.

### Credit cost

1 credit per 100 matched titles. Unmatched titles do not consume credits.

## POST /v9/jobs/title-lookup

> Look up the function and level for job titles

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v9"},"servers":[{"url":"https://api.sumble.com"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"LookupTitlesRequest":{"properties":{"titles":{"items":{"type":"string"},"type":"array","maxItems":1000,"minItems":1,"title":"Titles","description":"List of job titles to look up"}},"type":"object","required":["titles"],"title":"LookupTitlesRequest"},"LookupTitlesResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"matched_count":{"type":"integer","title":"Matched Count"},"results":{"items":{"$ref":"#/components/schemas/app__schemas__paid_api__jobs__LookupTitlesResponse__LookupResult"},"type":"array","title":"Results"}},"type":"object","required":["id","credits_used","credits_remaining","matched_count","results"],"title":"LookupTitlesResponse"},"app__schemas__paid_api__jobs__LookupTitlesResponse__LookupResult":{"properties":{"input":{"type":"string","title":"Input"},"job_function":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__paid_api__jobs__LookupTitlesResponse__JobFunction"},{"type":"null"}]},"job_level":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__paid_api__jobs__LookupTitlesResponse__JobLevel"},{"type":"null"}]}},"type":"object","required":["input","job_function","job_level"],"title":"LookupResult"},"app__schemas__paid_api__jobs__LookupTitlesResponse__JobFunction":{"properties":{"id":{"type":"integer","title":"Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","slug","name"],"title":"JobFunction"},"app__schemas__paid_api__jobs__LookupTitlesResponse__JobLevel":{"properties":{"id":{"type":"integer","title":"Id"},"name":{"type":"string","title":"Name"},"level_rank":{"type":"integer","title":"Level Rank"}},"type":"object","required":["id","name","level_rank"],"title":"JobLevel"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v9/jobs/title-lookup":{"post":{"tags":["jobs"],"summary":"Look up the function and level for job titles","operationId":"lookup_job_titles__api_version__jobs_title_lookup_post","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTitlesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTitlesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```