{
  "tool": "matric-nqf4.hist_timeline",
  "name": "Timeline span (CDU-GEN-NSC-400)",
  "answers": "The span in years between two dated events; an end year before the start year is refused.",
  "degree": {
    "id": "competency:matric-nqf4",
    "code": "CDU-GEN-NSC-400",
    "name": "Senior Certificate (Amended) — exam-readiness programme (NQF 4 matric)",
    "version": "1.0.0"
  },
  "reference": "Umalusi/NSC subject catalogue, worked reference (offline reconstruction); History row of §4 — a timeline span and a source-weighting total",
  "endpoint": "/faculty/matric-nqf4/hist_timeline",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "startYear",
      "endYear"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "startYear": {
        "type": "number",
        "description": "the earlier year",
        "minimum": -3000,
        "maximum": 3000
      },
      "endYear": {
        "type": "number",
        "description": "the later year",
        "minimum": -3000,
        "maximum": 3000
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "spanYears"
    ],
    "properties": {
      "spanYears": {
        "type": "number",
        "description": "years between the two"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "startYear": 1948,
    "endYear": 1994
  }
}