{
  "$schema": "https://govschema.org/spec/v0.3/govschema.schema.json",
  "govschemaVersion": "0.3.0",
  "id": "ca/on/mto/drivers-licence-renewal",
  "version": "1.0.0",
  "title": "Ontario Driver's Licence Renewal",
  "description": "Renew a full Ontario driver's licence (class G, M, or GM, or the full portion of a combination class G1M/G2M/GM1/GM2) online or in person through ServiceOntario, on behalf of the Ontario Ministry of Transportation. This document models the standard 5-year renewal path for a licence holder who is not in the 80-years-and-over renewal program: the online-eligibility screening (cancellation/suspension, a 90-day address-change lockout, no outstanding vision/written/road test, no new medical condition, no outstanding fines or penalties, and no need for a new photo or signature), the licence class and current expiry being renewed, the three identifiers the online service asks for (licence number, the 7-digit trillium number printed on the back of the card, and postal code on file), and online payment of the renewal fee. It pairs with us/ca/dmv/drivers-license-renewal, gb/dvla/driving-licence-renewal-photocard, and ie/dttas/driving-licence-renewal to show the same process across four jurisdictions. It does not model: the 80-years-and-over biennial renewal program (a separate service with its own vision screening, cognitive screening, and mandatory driver education review); renewal of a licence expired long enough to require a vision, written, or road test, or expired more than 10 years and requiring reapplication as a new driver (see 'Renew an expired licence'); the in-person-only paths themselves (address change, new photo/signature, medical/vision review, licence class changes, sex-designation changes); G1/G2/M1/M2 learner-only licences; or combined driver's-licence-and-health-card renewal. It does not submit the renewal; the live ontario.ca and services.ontario.ca sources are always authoritative (see VERIFICATION.md).",
  "status": "draft",
  "jurisdiction": {
    "country": "CA",
    "level": "subnational",
    "subdivision": "CA-ON"
  },
  "authority": {
    "name": "Ontario Ministry of Transportation",
    "abbreviation": "MTO",
    "url": "https://www.ontario.ca/page/ministry-transportation"
  },
  "process": {
    "type": "renewal",
    "language": "en-CA"
  },
  "source": {
    "url": "https://www.ontario.ca/page/renew-drivers-licence",
    "retrievedAt": "2026-07-02",
    "documentRef": "No form number — online self-service renewal via the ServiceOntario Driver's Licence Renewal service (services.ontario.ca)"
  },
  "verification": {
    "method": "manual-source-review-v1",
    "lastVerifiedAt": "2026-07-02",
    "verifiedBy": "GovSchema Engineering (Standards Engineer)",
    "nextReviewBy": "2027-01-01",
    "notes": "Source-derived reference schema authored from the official ontario.ca 'Renew your driver's licence' page (online eligibility gates, required identifiers, licence classes, fee, photo/timeline rules), cross-checked against 'Renew an expired driver's licence' and 'Renew your G driver's licence: 80 years and over' to draw this schema's scope boundary (both of those pages describe distinct, out-of-scope services, not this one) and against the general 'Driver's licence' overview page for licence-class names. The live, authenticated services.ontario.ca renewal service itself (where the licence number/trillium number/postal code are actually entered) was not independently reachable pre-authentication, so its screen-by-screen field list is not confirmed beyond what the ontario.ca guidance pages themselves state. Status remains 'draft'. See VERIFICATION.md."
  },
  "maturity": {
    "level": "structural-reference",
    "criteria": {
      "structuralReference": true,
      "verifiedSchema": false,
      "agentReadySchema": false,
      "executionTestedSchema": false
    },
    "method": "maturity-self-assessment-v1",
    "assertedBy": "GovSchema Engineering (Standards Engineer)",
    "assertedAt": "2026-07-02"
  },
  "license": "CC-BY-4.0",
  "fields": [
    {
      "name": "turns80OrOlderAtRenewal",
      "label": "Will you be 80 years of age or older at the time of this renewal?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "Drivers turning 80 or older must renew a G-class licence every 2 years, in person at a ServiceOntario centre, with a vision screening (or a recent optometrist's vision report), a cognitive screening exercise, and mandatory review of senior driver education material and the Driver's Handbook. This is a separate program from the standard renewal modelled here; if true, the flow ends and the applicant must use that in-person 80+ renewal service instead.",
      "sourceRef": "Renew your G driver's licence: 80 years and over — Renewal frequency and requirements"
    },
    {
      "name": "licenceCancelledOrSuspended",
      "label": "Is your driver's licence currently cancelled or suspended?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "Online renewal requires the licence not be cancelled or suspended. If true, the flow ends and the applicant must visit a ServiceOntario centre in person instead.",
      "sourceRef": "Renew your driver's licence — Eligibility for online renewal: 'License isn't cancelled or suspended'"
    },
    {
      "name": "addressChangedWithinLast90Days",
      "label": "Have you changed your address within the last 90 days?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "Online renewal requires no address change on file within the last 90 days. If true, the flow ends and the applicant must visit a ServiceOntario centre in person instead.",
      "sourceRef": "Renew your driver's licence — Eligibility for online renewal: 'Haven't updated your address within 90 days'; 'Recent movers cannot renew online within 90 days of address changes'"
    },
    {
      "name": "requiresVisionWrittenOrRoadTest",
      "label": "Do you need to complete a vision, written knowledge, or road test to renew?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "Online renewal requires that no vision, written, or road test is currently required. If true, the flow ends and the applicant must visit a DriveTest centre or ServiceOntario centre in person instead.",
      "sourceRef": "Renew your driver's licence — Eligibility for online renewal: 'Don't require vision, written, or road tests'"
    },
    {
      "name": "hasNewMedicalCondition",
      "label": "Do you have a new medical condition that may affect your ability to drive safely?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "Online renewal requires no new medical condition affecting driving ability. If true, the flow ends and the applicant must visit a ServiceOntario centre in person instead.",
      "sourceRef": "Renew your driver's licence — Eligibility for online renewal: 'Have no new medical conditions affecting driving ability'"
    },
    {
      "name": "hasOutstandingFinesOrPenalties",
      "label": "Do you have any outstanding fines or penalties?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "Online renewal requires no outstanding fines or penalties. If true, the flow ends and the applicant must resolve these, then visit a ServiceOntario centre in person instead.",
      "sourceRef": "Renew your driver's licence — Eligibility for online renewal: 'Don't have outstanding fines or penalties'"
    },
    {
      "name": "requiresNewPhotoOrSignature",
      "label": "Do you need a new photo or signature on your licence?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "A new photo is mandatory every 10 years and otherwise available on demand for an additional fee; a new signature can also be requested. Either requires an in-person visit — online renewal reuses the photo and signature already on file. If true, the flow ends and the applicant must visit a ServiceOntario centre in person instead.",
      "sourceRef": "Renew your driver's licence — 'If you are not eligible to renew online, or if you need a new photo or signature, visit any ServiceOntario centre'; Photo requirements section"
    },
    {
      "name": "licenceClass",
      "label": "Licence class being renewed",
      "type": "enum",
      "required": true,
      "description": "The full driver's licence class held. Combination classes pair a full class with a motorcycle learner class (G1M, G2M) or a car/van learner class with a full motorcycle class (GM1, GM2); online renewal only renews the full portion of a combination class.",
      "sourceRef": "Renew your driver's licence — 'full licence (G, M or GM class)'; 'Combination classes (G1M, G2M, GM1, GM2) can renew online, though only the full portion will be renewed online'",
      "validation": { "enum": ["G", "M", "GM", "G1M", "G2M", "GM1", "GM2"] }
    },
    {
      "name": "currentLicenceExpiryDate",
      "label": "Current licence expiry date",
      "type": "date",
      "required": true,
      "description": "The expiry date printed on the licence being renewed. An Ontario driver's licence is valid for 5 years. Renewing within 28 days of this date (or after it has already passed, within the eligible online-renewal window) triggers issuance of a downloadable Temporary Driver's Licence Validation Document to drive legally while the new card is mailed.",
      "sourceRef": "Renew your driver's licence — 'An Ontario driver's licence is valid for 5 years...'; 'Temporary Documentation' section"
    },
    {
      "name": "licenceNumber",
      "label": "Driver's licence number",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The driver's licence number printed on the front of the current physical licence card.",
      "sourceRef": "Renew your driver's licence — Required Documents for Online Renewal: 'Driver's licence number'",
      "validation": { "minLength": 1, "maxLength": 20 }
    },
    {
      "name": "trilliumNumber",
      "label": "Trillium number",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The 7-digit trillium number printed on the back of the current physical licence card, between asterisks. It identifies the physical card itself (not the licence holder) and is distinct from the licence number.",
      "sourceRef": "Renew your driver's licence — 'The 7-digit trillium number is printed on the back of your driver's licence'",
      "validation": { "pattern": "^[0-9]{7}$", "minLength": 7, "maxLength": 7 }
    },
    {
      "name": "postalCode",
      "label": "Postal code on file",
      "type": "string",
      "required": true,
      "classification": "pii",
      "description": "The Canadian postal code currently on file for the licence, used together with the licence number and trillium number to verify identity for online renewal.",
      "sourceRef": "Renew your driver's licence — 'you'll need to enter your licence number, trillium number, and postal code'",
      "validation": { "pattern": "^[A-Za-z][0-9][A-Za-z][ ]?[0-9][A-Za-z][0-9]$", "minLength": 6, "maxLength": 7 }
    },
    {
      "name": "paymentMethod",
      "label": "Online payment method",
      "type": "enum",
      "required": true,
      "description": "How the renewal fee (base $90 for a standard 5-year renewal, prorated for a shorter remaining validity period) is paid online. Accepted card brands were not independently confirmed for this specific service and are therefore not enumerated here.",
      "sourceRef": "Renew your driver's licence — Fees and Timeline: '$90 for a 5-year licence'",
      "validation": { "enum": ["credit_card", "debit_card"] }
    }
  ],
  "steps": [
    {
      "id": "eligibility",
      "title": "Online renewal eligibility",
      "fields": [
        "turns80OrOlderAtRenewal",
        "licenceCancelledOrSuspended",
        "addressChangedWithinLast90Days",
        "requiresVisionWrittenOrRoadTest",
        "hasNewMedicalCondition",
        "hasOutstandingFinesOrPenalties",
        "requiresNewPhotoOrSignature"
      ],
      "transitions": [
        {
          "to": null,
          "exitReason": "not-eligible-80-and-over-renewal-program",
          "when": { "field": "turns80OrOlderAtRenewal", "equals": true }
        },
        {
          "to": null,
          "exitReason": "not-eligible-licence-cancelled-or-suspended",
          "when": { "field": "licenceCancelledOrSuspended", "equals": true }
        },
        {
          "to": null,
          "exitReason": "not-eligible-recent-address-change",
          "when": { "field": "addressChangedWithinLast90Days", "equals": true }
        },
        {
          "to": null,
          "exitReason": "not-eligible-test-required",
          "when": { "field": "requiresVisionWrittenOrRoadTest", "equals": true }
        },
        {
          "to": null,
          "exitReason": "not-eligible-new-medical-condition",
          "when": { "field": "hasNewMedicalCondition", "equals": true }
        },
        {
          "to": null,
          "exitReason": "not-eligible-outstanding-fines",
          "when": { "field": "hasOutstandingFinesOrPenalties", "equals": true }
        },
        {
          "to": null,
          "exitReason": "not-eligible-new-photo-or-signature-required",
          "when": { "field": "requiresNewPhotoOrSignature", "equals": true }
        },
        { "to": "licence_details" }
      ]
    },
    {
      "id": "licence_details",
      "title": "Licence being renewed",
      "fields": ["licenceClass", "currentLicenceExpiryDate"],
      "next": "identify"
    },
    {
      "id": "identify",
      "title": "Identify your licence",
      "fields": ["licenceNumber", "trilliumNumber", "postalCode"],
      "next": "payment"
    },
    {
      "id": "payment",
      "title": "Payment",
      "fields": ["paymentMethod"]
    }
  ]
}