Skip to content

Classify a single executive job title

Use POST /v1/classify-title to classify one executive job title against the ESInsight taxonomy.

FieldTypeRequiredConstraints
titlestringyes1–300 characters
{ "title": "Interim CFO" }
{
"title": "Interim CFO",
"management_level": "c_suite",
"is_non_executive": false,
"is_partner": false,
"is_vp": false,
"is_owner": false,
"function": ["finance"],
"standard_roles": ["chief_financial_officer"],
"employment_type": "interim",
"flag_assistant": false,
"versions": { "taxonomy": "1.0.0", "patterns": "1.0.1" }
}

Every field is documented in Response fields & taxonomy. Validation and other failures return the standard error envelope.