VisitID — Title Classification API

Endpoints

POST /title_level Classify a job title

Submit a job title to receive its standardized function family and seniority level classification. Uses a rules engine with AI fallback for maximum accuracy.

Request

Response

Examples

Try It

Headers

Name	Value
Content-Type	application/json
X-API-Key	string REQUIRED

Request Body

Field	Type	Required	Description
title	string	REQUIRED	The job title to classify (e.g., "VP of Engineering")

JSON { "title": "Chief Marketing Officer" }

cURL Example

Shell curl -X POST https://investid.app.n8n.cloud/webhook/title_level \ -H "Content-Type: application/json" \ -H "X-API-Key: your-api-key-here" \ -d '{"title": "Chief Marketing Officer"}'

Response Body

Field	Type	Description
title	string	The original job title submitted
function_family	string	The functional category of the role Board CEO Operations HR & Talent Sales & Marketing Finance & Accounting Legal & Compliance Technology Product & AI Cybersecurity & Risk Other
level_family	string	The seniority level of the role Board C-Suite Functional Leadership Other

Status Codes

200
OK — Title classified successfully.
400
Bad Request — Missing or empty title field.
403
Forbidden — Invalid or missing API key.
500
Internal Server Error — Classification service encountered an error. Retry after a few seconds.

C-Suite Executive

            Response
{
  "title": "Chief Marketing Officer",
  "function_family": "Sales & Marketing",
  "level_family": "C-Suite"
}
          

Functional Leadership

            Response
{
  "title": "VP of Engineering",
  "function_family": "Technology Product & AI",
  "level_family": "Functional Leadership"
}
          

Board Member

            Response
{
  "title": "Independent Board Director",
  "function_family": "Board",
  "level_family": "Board"
}
          

General Role

            Response
{
  "title": "Marketing Coordinator",
  "function_family": "Sales & Marketing",
  "level_family": "Other"
}
          

Live API — This sends a real request to the production endpoint.

API Key Job Title

Response

VisitID Title Classification API v1.0

Base URL

Authentication