Occupation API

Occupation endpoints provide O*NET 30.3-grounded context for known occupation codes.

Complete executable examples belong in the AvelinLabs API examples repository.

Base URL: https://api.avelinlabs.com

Authentication

Requires a runtime API key:

Authorization: Bearer <runtime-api-key>

GET /api/v1/occupation/{onet_code}

Use this endpoint to retrieve a concise occupation summary for a known O*NET code.

Path Parameter: onet_code

Type: string

Required: Yes

Meaning: O*NET occupation code, for example 15-1252.00.

Minimal Response

Illustrative beta response snippet:

{
  "onet_code": "15-1252.00",
  "title": "Software Developers",
  "top_skills": [
    {
      "skill_name": "Programming",
      "importance": 92.5,
      "level": 78.0
    }
  ]
}

See the public example response: responses/occupation.example.json.

Response Field: onet_code

Meaning: O*NET occupation code returned by the lookup.

Response Field: title

Meaning: Occupation title.

Response Field: top_skills

Meaning: Array of high-signal skill records associated with the occupation.

Response Field: top_skills[].skill_name

Meaning: Skill name.

Response Field: top_skills[].importance

Meaning: Relative importance score for the skill.

Response Field: top_skills[].level

Meaning: Relative level score for the skill.

GET /api/v1/occupation/profile/{onet_code}

Use this endpoint when an application needs a richer occupation profile for display, enrichment, or review workflows.

Path Parameter: onet_code

Type: string

Required: Yes

Meaning: O*NET occupation code, for example 15-1252.00.

Minimal Response

Illustrative beta response snippet:

{
  "occupation": {
    "onet_code": "15-1252.00",
    "title": "Software Developers",
    "description": "Research, design, and develop computer and network software or specialized utility programs."
  },
  "skills": [
    {
      "name": "Programming",
      "importance": 92.5,
      "level": 78.0
    }
  ],
  "technologies": [
    {
      "name": "Python",
      "is_hot": true,
      "is_in_demand": true
    }
  ],
  "tasks": ["Develop software systems and applications."]
}

See the public examples repository for occupation examples: AvelinLabs API examples.

Response Field: occupation

Meaning: Main occupation object.

Response Field: occupation.onet_code

Meaning: O*NET occupation code.

Response Field: occupation.title

Meaning: Occupation title.

Response Field: occupation.description

Meaning: Public occupation description where available.

Response Field: skills

Meaning: Skill records with names, importance, and level values.

Response Field: technologies

Meaning: Software/technology records associated with the occupation. The public field name remains technologies for API compatibility.

Response Field: technologies[].name

Meaning: Software or technology name.

Response Field: technologies[].is_hot

Meaning: Indicates whether the software/technology term is marked as hot where available.

Response Field: technologies[].is_in_demand

Meaning: Indicates whether the software/technology term is marked as in demand where available.

Response Field: tasks

Meaning: Task statements associated with the occupation.

Response Field: related_occupations

Meaning: Related occupation records with O*NET codes, titles, and relatedness tiers where available.

Interpretation Notes

Occupation endpoints are useful for enriching UI displays, explaining classification outputs, and adding standardized occupation context to workflows.

For cross-endpoint guidance, read output interpretation and standard error responses.