{
  "$schema": "https://govschema.org/spec/v0.3/govschema.schema.json",
  "govschemaVersion": "0.3.0",
  "id": "gb/dvla/lorry-bus-provisional-licence",
  "version": "1.0.0",
  "title": "United Kingdom Provisional Lorry (HGV) or Bus (PCV) Driving Licence",
  "description": "Apply for a first provisional heavy goods vehicle (HGV, categories C1/C1E/C/CE) or bus/coach (PCV, categories D1/D1E/D/DE) entitlement through the Driver and Vehicle Licensing Agency (DVLA), by post using form D2 (application) and form D4 (medical examination report, completed by a doctor). This is the vocational/CDL leg of the DMV vertical's 'Drivers License' coverage named in GOV-986: every previously published GB driving-licence schema (gb/dvla/driving-licence-renewal-photocard, gb/dvla/driving-licence-first-provisional) covers only the standard car (category B) licence, and this registry's only prior commercial/vocational-licence schema (us/ca/dmv/commercial-drivers-license-application) is US-only. The provisional entitlement obtained here is a prerequisite to sitting the 5-part Driver Certificate of Professional Competence (CPC) tests; those tests, and the full (post-CPC) HGV/bus licence itself, are out of scope. It does not submit the application; the live gov.uk and DVLA sources are always authoritative (see VERIFICATION.md).",
  "status": "draft",
  "jurisdiction": {
    "country": "GB",
    "level": "national"
  },
  "authority": {
    "name": "Driver and Vehicle Licensing Agency",
    "abbreviation": "DVLA",
    "url": "https://www.gov.uk/government/organisations/driver-and-vehicle-licensing-agency"
  },
  "process": {
    "type": "application",
    "language": "en-GB"
  },
  "source": {
    "url": "https://www.gov.uk/become-lorry-bus-driver",
    "retrievedAt": "2026-07-04",
    "documentRef": "Form D2 (application) and Form D4 (medical examination report); no downloadable D2/D4 PDF is published (Post Office channel only)"
  },
  "verification": {
    "method": "manual-source-review-v1",
    "lastVerifiedAt": "2026-07-04",
    "verifiedBy": "GovSchema Engineering (Standards Engineer)",
    "nextReviewBy": "2027-01-01",
    "notes": "Authored from the official gov.uk 'Become a qualified heavy goods vehicle (HGV) or bus driver' guide (retrieved via the gov.uk content API, /api/content/become-lorry-bus-driver) — specifically its 'Applying for a provisional HGV or bus licence' and 'Fees' parts — plus the companion 'Driving licence categories' page for the category enum and 'Renew or change a lorry or bus licence' for scope boundaries. Forms D2 and D4 are Post-Office-only (no downloadable PDF was found, the same access pattern already recorded for form D1 in the sibling gb/dvla/driving-licence-first-provisional), so no official field-by-field D2/D4 specification exists to extract from; field detail beyond the two guidance pages is not independently confirmed. Status remains 'draft'. See VERIFICATION.md for the full source list and honesty flags."
  },
  "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-04"
  },
  "license": "CC-BY-4.0",
  "fields": [
    {
      "name": "fullCarLicenceHeld",
      "label": "Do you hold a full (non-provisional) GB car driving licence?",
      "type": "boolean",
      "required": true,
      "fieldRole": "eligibility",
      "description": "A full car licence (category B) is a precondition for a lorry/bus provisional entitlement; the applicant's existing photocard licence is itself sent as part of this application. If false, the applicant is not eligible for this service.",
      "sourceRef": "Become a qualified HGV or bus driver — 'Getting qualified': 'have a full car licence'"
    },
    {
      "name": "dateOfBirth",
      "label": "Date of birth",
      "type": "date",
      "classification": "sensitive-pii",
      "required": true,
      "fieldRole": "eligibility",
      "description": "Personal identifier; handle as sensitive data. Full date, YYYY-MM-DD. An applicant must generally be over 18, though the source notes 'some exceptions' (linked to a separate vehicles-you-can-drive page covering, e.g., certain armed-forces and exempt-vehicle cases) that this schema does not model — see VERIFICATION.md.",
      "sourceRef": "Become a qualified HGV or bus driver — 'Getting qualified': 'be over 18 - but there are some exceptions'"
    },
    {
      "name": "lastName",
      "label": "Last name",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Not independently confirmed against an official D2 field list; modelled by analogy with the sibling gb/dvla/driving-licence-first-provisional's applicant-detail fields, since every GB DVLA licence application collects a name at minimum — see VERIFICATION.md.",
      "sourceRef": "Form D2 applicant details (by analogy with gb/dvla/driving-licence-first-provisional; not independently re-confirmed for this specific form)",
      "validation": { "minLength": 1, "maxLength": 100 }
    },
    {
      "name": "firstNames",
      "label": "First name(s)",
      "type": "string",
      "required": true,
      "description": "Personal identifier; handle as sensitive data. Not independently confirmed against an official D2 field list; modelled by analogy with the sibling gb/dvla/driving-licence-first-provisional's applicant-detail fields — see VERIFICATION.md.",
      "sourceRef": "Form D2 applicant details (by analogy with gb/dvla/driving-licence-first-provisional; not independently re-confirmed for this specific form)",
      "validation": { "minLength": 1, "maxLength": 100 }
    },
    {
      "name": "licenceCategoryApplied",
      "label": "Which provisional category are you applying for?",
      "type": "enum",
      "required": true,
      "description": "c1 = provisional C1 only; c = provisional C1, C1E, C and CE (choosing either C or C1E gives the same combined entitlement, per the source's own grouped table row); c1e = same combined C-group entitlement as choosing c; d1 = provisional D1, D1E, D and DE (choosing either D or D1 gives the same combined entitlement); d = same combined D-group entitlement as choosing d1. Category definitions (weight/passenger-seat/trailer limits) are documented on the linked 'Driving licence categories' page, not repeated here.",
      "sourceRef": "Become a qualified HGV or bus driver — 'Filling in form D2' category/entitlement table",
      "validation": { "enum": ["c1", "c", "c1e", "d1", "d"] }
    },
    {
      "name": "currentLicenceFormat",
      "label": "Is your current GB driving licence a photocard or a paper licence?",
      "type": "enum",
      "required": true,
      "description": "Gates the supporting-document requirements below: a photocard licence is sent with the application as-is; a paper licence additionally requires a passport-style colour photo and original identity documents.",
      "sourceRef": "Become a qualified HGV or bus driver — 'Send the forms': 'If you have a paper driving licence you must include a passport-style colour photo and original identity documents.'",
      "validation": { "enum": ["photocard", "paper"] }
    },
    {
      "name": "d4MedicalReportCompleted",
      "label": "Has a doctor (or optician, for the eyesight section) completed form D4 on your behalf?",
      "type": "boolean",
      "required": true,
      "description": "Form D4 must be filled in by a GP or a private firm specialising in drivers' medical exams (an optician may need to complete the eyesight section); the doctor/firm/optician can charge for this. Corresponds to the D4 form itself, not modelled field-by-field here (out of scope; the underlying medical questionnaire content was not sourced) — see VERIFICATION.md.",
      "sourceRef": "Become a qualified HGV or bus driver — 'Filling in form D4'"
    }
  ],
  "documents": [
    {
      "id": "d2ApplicationForm",
      "label": "Completed form D2 (application for a provisional lorry or bus licence)",
      "category": "supporting-evidence",
      "required": true,
      "sourceRef": "Become a qualified HGV or bus driver — 'How to apply': 'fill in ... a D2 application form'"
    },
    {
      "id": "d4MedicalExaminationReport",
      "label": "Completed form D4 (medical examination report)",
      "category": "supporting-evidence",
      "required": true,
      "sourceRef": "Become a qualified HGV or bus driver — 'How to apply': 'a D4 medical examination report - this must be filled in by a doctor'"
    },
    {
      "id": "currentPhotocardLicence",
      "label": "Current photocard driving licence",
      "category": "identity-document",
      "required": false,
      "requiredWhen": { "field": "currentLicenceFormat", "equals": "photocard" },
      "sourceRef": "Become a qualified HGV or bus driver — 'Send the forms': 'Send both forms and your photocard driving licence to DVLA.'"
    },
    {
      "id": "passportStyleColourPhoto",
      "label": "Passport-style colour photo",
      "category": "identity-document",
      "required": false,
      "requiredWhen": { "field": "currentLicenceFormat", "equals": "paper" },
      "sourceRef": "Become a qualified HGV or bus driver — 'Send the forms': 'If you have a paper driving licence you must include a passport-style colour photo and original identity documents.'"
    },
    {
      "id": "originalIdentityDocuments",
      "label": "Original identity documents",
      "category": "identity-document",
      "required": false,
      "requiredWhen": { "field": "currentLicenceFormat", "equals": "paper" },
      "sourceRef": "Become a qualified HGV or bus driver — 'Send the forms': 'If you have a paper driving licence you must include a passport-style colour photo and original identity documents.'"
    }
  ],
  "steps": [
    {
      "id": "eligibility",
      "title": "Eligibility",
      "fields": ["fullCarLicenceHeld", "dateOfBirth"],
      "transitions": [
        {
          "to": null,
          "exitReason": "not-eligible-no-full-car-licence",
          "when": { "field": "fullCarLicenceHeld", "equals": false }
        },
        { "to": "applicant_and_category" }
      ]
    },
    {
      "id": "applicant_and_category",
      "title": "Applicant details and category applied for",
      "fields": ["lastName", "firstNames", "licenceCategoryApplied"],
      "next": "medical_and_licence_format"
    },
    {
      "id": "medical_and_licence_format",
      "title": "Medical report and current licence format",
      "fields": ["currentLicenceFormat", "d4MedicalReportCompleted"]
    }
  ]
}