CORE OBJECTv0.1-draft

ReviewAttestation

Portable review summaries with provenance.

Spec → ReviewAttestation

What is ReviewAttestation? A portable, source-attributed review summary. UKLSP carries attestations about reviews, not review bodies — agents can weigh provenance.

Reviews live on many platforms; UKLSP doesn't republish them, it attests to them: source, rating, count, when sampled, and who sampled it. Agents get provenance-weighted signals instead of scrape-of-a-scrape numbers, and platform terms are respected because review bodies never enter the manifest.

Fields

FieldTypeNotes
sourcestring · enumREQUIRED Values: google_business, checkatrade, trustpilot, operator_verified_job, other
source_urlstring
rating_valuenumberREQUIRED
rating_countintegerREQUIRED
sampled_datestringREQUIRED
attested_bystringREQUIRED Who sampled the figure, e.g. operator name.

Example

{
  "source": "google_business",
  "source_url": "https://example.com/reviews/your-listing",
  "rating_value": 4.8,
  "rating_count": 57,
  "sampled_date": "2026-07-20",
  "attested_by": "Greenboard"
}

Schema: review-attestation.schema.json (JSON Schema 2020-12, MIT).