UKLSP UK Local Services Protocol v0.1-draft

CERTIFICATIONHARNESS v0.1.0

Certification

Three stations on one line. A badge is a promise with a report hash behind it.

What does UKLSP certification prove? That a provider listing keeps machine promises: valid structure at Level 1, honest prices and credentials at Level 2, and a live bookable endpoint at Level 3. Every badge traces to a deterministic report hash produced by the open-source harness.

The levels in detail

LevelNameRequirements (cumulative)
1DiscoverableManifest validates against provider.schema.json; legal identity and postcode-district coverage present.
2QuotableEvery capability priced (fixed/from with a GBP price, or quote_only with price_notes); all required_credential_types satisfied; no expired credentials.
3BookableBooking endpoint declared, plus slot evidence: a validating slot sample or a live /slots fetch returning ≥1 valid slot.

Running the harness

python3 harness.py provider-manifest.json            # Levels 1–2
python3 harness.py provider-manifest.json --live      # Level 3 against the live endpoint
python3 harness.py provider-manifest.json --slots sample.json   # Level 3, offline evidence

Output is a JSON report listing every check, error and warning, plus a 16-hex report hash. Re-running on a changed manifest changes the hash and voids the badge until re-issued.

Badges

UKLSP Level 1 Discoverable badge UKLSP Level 2 Quotable badge UKLSP Level 3 Bookable badge

Badges are the stations on the line: each one lights when the level is earned. Display terms: link the badge to your row on the public register, and remove it if the report hash there no longer matches your live manifest.

Common questions

What do the three UKLSP certification levels mean?

Level 1 (Discoverable) means a valid manifest with identity and coverage. Level 2 (Quotable) adds machine-readable pricing on every capability and the statutory credentials each one requires. Level 3 (Bookable) adds a live booking endpoint with server-authoritative slots, proven by slot evidence.

How is certification checked?

By an open-source harness that validates the manifest against the published JSON Schemas and applies the level rules. Reports are deterministic: the same inputs always produce the same report hash, so a badge can be traced to the exact state that earned it.

Does certification cost anything?

Not during the draft period. A pricing model for certification and listing will be published once the network reaches meaningful scale, and early implementers will be grandfathered on fair terms.

Does a UKLSP badge mean the operator has verified a provider's Gas Safe or NICEIC registration?

Only if the credential shows verified_by_operator=true with a date. Certification checks that references are present, well-formed and unexpired; register verification is a separate, honestly-labelled step.