Skip to content

Latest commit

 

History

History
72 lines (55 loc) · 1.91 KB

CompanyJobTitles.md

File metadata and controls

72 lines (55 loc) · 1.91 KB

Company Job Titles

Table of Contents

Summary

The Company Job Titles service provides a list of job titles (along with their ONet and Carotene classifications) that are personalized for a given company. Company Job Titles is available at /core/company/jobtitles.

Request Structure

Requests consist of a company_id and country string:

{
	"company_id": "NC6623058c-2e0b-4998-ac4a-72e478e91337",
	"country": "us",
	"carotene_version": "carotenev3",
	"onet_version": "onet17"
}

company_id is required. country is optional and defaults to 'US' if not specified. Currently supported countries are:

  • US
  • UK

The ONet and Carotene versions currently supported are listed in the Versioning section of this document and are subject to change over time. Any removal of support for a taxonomy version will be implemented as a versioned change to the API itself.

Response Structure

Response consist of a list of job_titles where each item contains a job_title string and its associated ONet and Carotene classification code.

{
    "data": {
        "job_titles": [
            {
                "job_title": "Clerical Assistant",
                "onet_code": "43-4051.00",
                "carotene_code": "43.106"
            },
            {
                "job_title": "Commercial Account Manager / Department Manager",
                "onet_code": "41-3021.00",
                "carotene_code": "41.12"
            }
        ]
    }
}

Versioning

The current version of the service is 1.0.

Currently ONet17 and Carotene v3 classifications are available.

Version must be specified in the Accept header. E.g. application/json;version=1.0.

Our general versioning strategy is available here.