knowledge

Resolve a job title, a company's internal name for a role, a nickname or a degree name to a canonical VOLO entity. Call this FIRST whenever a person names their job. Returns a match field of exact or approximate — when it is approximate, say which entity you read the question as. Returns null when VOLO does not cover it, which is a gap in this site and not a statement about the job.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

Search occupations, majors and verified change records by keyword. Returns entries, not judgements.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "required": [
    "query"
  ]
}

Full task-level assessment of one occupation. Every task carries direction, basis (evidenced vs inferred) and limits — what that judgement does NOT establish. The impact index is not a probability of job loss and never appears without its confidence and assessment date.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Where an occupation or a degree sits in the official classifications (U.S. Department of Labor O*NET 31.0; U.S. Department of Education CIP–SOC crosswalk; the EU's ESCO, the ILO's ISCO-08 and Singapore's SSOC 2024): the matching codes with how well each fits, the skills, knowledge and work activities O*NET rates highest (as O*NET's own importance words, no numbers), related occupations and which degrees lead to it; each of this site's tasks aligned to O*NET detailed work activities (or why none fits); and the rules this site's verified records read, with the verb that matters and whom it binds. For a degree: where the official crosswalk and this site's paths agree and disagree. Every block names its source. O*NET says what a job demands, not what automation is doing to it; never combine it with the impact index.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Walk the VOLO Ontology directly. No arguments: the object types and link types. `type`: the objects of that type. `type` + `id`: one object's properties and everything it links to, grouped by link. Add `link` (and `direction`: out|in) to follow one link. Types include Occupation, Task, TaskJudgement, Evidence, Regulation, WorkActivity and ClassificationConcept. Read-only; judgements keep their basis and limits, evidence its scope — carry them into the answer. No aggregate score exists.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "link": {
      "type": "string"
    },
    "direction": {
      "type": "string",
      "enum": [
        "out",
        "in"
      ]
    },
    "locale": {
      "type": "string"
    }
  }
}

The task breakdown for one occupation. The unit of assessment is the task, never the job title.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Verified evidence records for an occupation, optionally for one task. Each record carries its scope (where it applies), its stage, whether that stage can move a task judgement at all, and its source tier. Repeat the scope rather than smoothing it away.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "taskId": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

One verified change record by id, with VOLO's reading: what it means, what it does not yet establish, and what a reader can verify themselves.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Which occupation and which specific tasks a change record bears on.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

The verified change timeline for an occupation, oldest first.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Options for someone in this occupation. Every path carries its real constraints (time, pay cut, seniority) and one action they can take this week that produces information. Never present a path without its constraint.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

For the business side: the functions a company is organised into, and which occupations sit in each. Use this when someone describes a company rather than themselves.

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string"
    }
  }
}

A degree and the occupations it feeds. There is no score for a major and never will be — answer 'should I switch majors' by pointing at where it leads and what transfers.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Which degrees lead into this occupation.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

VOLO's long-form answers to the big questions — how many jobs AI has actually taken, what actually gets automated, how long someone has, what AI law already changed, where AI lands in a company. Call this FIRST for any question that is about the whole picture rather than one occupation: those are exactly the questions you can answer fluently without evidence, and these notes are the evidence. Each result carries the note's own limits.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  }
}

The full text of one note, section by section, each section with the verified records it rests on. Use it when you need to quote or cite rather than summarise.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Which notes argue from this occupation's own records or task judgements. Use it to point someone from their own page to the wider answer.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

What VOLO covers and what it does not, including which occupations have no evidence yet. Call this when someone asks whether their job is covered, so the answer is a fact about this site rather than a guess about their job.

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string"
    }
  }
}