Batch executive job title classification

Use POST /v1/classify-titles to classify a batch of executive job titles in one call. Results are returned in the same order as the input.

One batch request counts as a single request against your rate limit and daily quota, so prefer this endpoint when classifying large volumes.

Request body

Field	Type	Required	Constraints
titles	array of strings	yes	1–500 items, each 1–300 characters

{ "titles": ["Interim CFO", "VP Sales EMEA"] }

Response — 200 OK

{
  "results": [
    { "title": "Interim CFO",   "...": "..." },
    { "title": "VP Sales EMEA", "...": "..." }
  ],
  "versions": { "taxonomy": "1.0.0", "patterns": "1.0.1" }
}

Each element of results has the same shape as the single-title response, except versions appears once at the top level rather than per result.

Validation errors identify the offending item by index (e.g. titles[41]), so you can fix or drop just that item and resubmit — see Errors.