Specification

OLE v0.1
Specification Documents

All specification documents for the Open Legal Exchange Protocol, Founding Architecture v0.1. Published May 2026.

OLE v0.1 — Published This is the v0.1 publication of the Open Legal Exchange Protocol. The architecture, data model, and API surface are stable for implementation. Normative JSON Schemas, conformance tests, and certification procedures are scoped to future versions. This is not legal advice.

Specification documents

The v0.1 specification is organized into focused documents. Start with the Founding Architecture for the full vision, then Core for data conventions, then the module specification you need.

spec/v0.1

Founding Architecture

Vision, the six governance primitives, the governance loop, adoption levels, the module architecture, trust model, and closing narrative.

spec/v0.1

Core Data Conventions

Resource envelope, identifier policy, external IDs, extension policy, visibility scope, ConsentRecord, AuditEvent, error model, idempotency, and webhook signing.

spec/v0.1 · Active Module

CLEAR — Legal Referral Exchange

Minimum referral workflow, status model, resource set, participant roles, API surface, webhook catalog, and security requirements.

spec/v0.1

Security Profile

Transport security, authentication (JWT/OAuth 2.0), webhook signing (HMAC-SHA256), data protection, consent, audit requirements, and API security.

spec/v0.1

Conformance

Conformance profiles for Pre-Tier (Packet) and Tier 1 (Exchange), self-declaration checklist, and conformance status values.

spec/v0.1

Governance

Stewardship model, decision-making process, contribution workflow, IP policy, versioning scheme, and stewardship maturity model.

spec/v0.1

Relationship to Existing Standards

OLE's relationship to SALI LMSS, LEDES, Akoma Ntoso, LegalRuleML, NIEM, W3C Verifiable Credentials, and FHIR — with mapping examples.

spec/v0.1

Publication Checklist

Pre-publication review checklist: document completeness, consistency checks, technical validation, safety review, known gaps, and publication steps.

Schemas, examples, and OpenAPI

All schemas use JSON Schema 2020-12. Examples are valid OLE JSON documents. The OpenAPI spec is a draft — full normative API requirements will be finalized in v0.2.

Artifact Path Description
Resource Envelope Schema schemas/v0.1/resource-envelope.schema.json JSON Schema for the OLE common resource envelope
Actor Schema schemas/v0.1/actor.schema.json JSON Schema for OLE Actor resources (human and AI)
ConsentRecord Schema schemas/v0.1/consent-record.schema.json JSON Schema for ConsentRecord resources
AuditEvent Schema schemas/v0.1/audit-event.schema.json JSON Schema for AuditEvent resources (includes AI audit sub-object)
Referral Schema schemas/v0.1/referral.schema.json JSON Schema for CLEAR Referral resources
Actor (attorney) example examples/v0.1/actor-attorney.json Human professional Actor
Actor (AI agent) example examples/v0.1/actor-ai-agent.json AI agent Actor with capabilities and constraints
ConsentRecord example examples/v0.1/consent-record.json ConsentRecord for a legal referral
AuditEvent example examples/v0.1/audit-event.json AuditEvent for a referral.sent action
Referral (sent) example examples/v0.1/referral-sent.json Complete CLEAR Referral resource
StatusUpdate example examples/v0.1/status-update-received.json CLEAR StatusUpdate resource
OpenAPI 3.1.0 (CLEAR) openapi/v0.1/ole-clear-v0.1.yaml Draft OpenAPI specification for the CLEAR module API

What v0.1 does not define

These items are intentionally deferred to v0.2 or v1.0.

ItemDeferred To
Final normative JSON Schemas with full field constraintsv0.2
CLEAR sandbox environment for schema validationv0.2
Fee settlement resource and workflowv0.2
Document exchange protocolv0.2
Conflict-check integration protocolv0.2
ConsentRecord revocation APIv0.2
Formal Contributor License AgreementBefore working group
Conformance certification programv1.0
Machine-testable conformance test suitev1.0
Trademark usage policyv1.0