v1.0 · releasedMIT · open source33 conforming schemas
the open contract layer · automotive retail

The open contract between AI agents and dealer systems.

Agents are already merchandising inventory, quoting deals, and answering leads on dealers' behalf — but every team reverse-engineers the rules by hand. Feed shapes, DMS writebacks, ADF-XML, credit apps, title math, OEM co-op. None of them knows when a spec changes.

DealerSchema is the standard sitting between agents and dealer systems — a versioned specification, a public registry of conforming schemas, and documented methods for verifying each one. Open, versioned, verifiable.

33
reference schemas
8
categories covered
90d
verification cadence
dealerschema · envelope verified
{
  "id":       "vendor.homenet.feed.v1.4",
  "spec":     "dealerschema/v1.0",
  "version":  "v1.4",
  "category": "inventory",
  "jurisdiction": "vendor: HomeNet iOL",
  "status":   "verified",
  "verifiedAt": "2026-06-14",
  "source":   "https://iol.homenetauto.com/…",
  "consumedBy": ["merchandiser", "pricing"],
  "fields":  [ /* typed field list */ ],
  "rules":   [ /* validation bullets */ ]
}
consumed bymerchandiserpricingconciergechief
spec · v1.0

What ships in v1.

v1.0 is the first stable cut of DealerSchema. Every entry in the registry conforms to the same envelope, the same versioning rules, and the same verification fixtures — so an agent written against v1 will still parse when a franchise or state adds a field next quarter.

envelope
One shape, every schema

Every registry entry ships id, spec version, category, jurisdiction, verification date, source, consuming agents, typed fields, and validation rules.

versioning
Semver + jurisdiction tags

Breaking changes bump the major. Jurisdiction (US-TN, OEM: Ford, vendor: HomeNet) is part of the id so state and franchise deltas never collide.

verification
Fixture-backed conformance

Every schema ships with sample payloads and rule assertions. CI in the reference repo re-verifies against live sources on a rolling schedule.

agents
Typed consumers

Schemas declare which agent roles (merchandiser, pricing, concierge, chief, ads, reputation, trade) are expected to read or write them.

governance
RFC-driven change

Field additions, deprecations, and jurisdiction expansions land through an open RFC in /spec/rfc — with a 14-day comment window before merge.

licensing
MIT, no vendor lock

Spec, schemas, and fixtures are MIT. Pitlane maintains the reference registry; anyone can fork it, mirror it, or ship a competing implementation.

Envelope, in one look
{
  "id": "vendor.homenet.feed.v1.4",
  "spec": "dealerschema/v1.0",
  "version": "v1.4",
  "category": "inventory",
  "jurisdiction": "vendor: HomeNet iOL",
  "status": "verified",
  "verifiedAt": "2026-06-14",
  "source": "https://iol.homenetauto.com/...",
  "consumedBy": ["merchandiser", "pricing"],
  "fields": [ /* typed field list */ ],
  "rules":  [ /* validation bullets */ ]
}
Governance rules
  • Ids are lowercase, dot-separated, and immutable once published.
  • Every field carries a type and a required flag; optional fields default to null, not omitted.
  • verifiedAt is ISO-8601 and must be re-asserted at least every 90 days or the entry moves to in-review.
  • Deprecations keep the field for one full major version with a deprecatedIn marker.
  • Jurisdiction-specific overrides extend a base schema; they never redefine field types silently.
what dealerschema publishes

Three artifacts. One contract.

v1.0
Specification

The open, versioned format every schema conforms to. Deterministic dotted paths, semantic versions, jurisdiction scoping.

Live
Registry

The public index of published schemas and their versions. 33 reference schemas across inventory, leads, pricing, DMS writeback, compliance, F&I, OEM programs, and titling.

Documented
Verification

How each schema is checked against its live source — vendor spec, government bulletin, or OEM program guide. Every entry ships with a verification date.

the registry

33 reference schemas.

Every entry has a deterministic ID, a version, a jurisdiction, a live source, and a verification date. Click any row to inspect fields, rules, and the Pitlane agents that consume it.

built in the open

Where DealerSchema is today.

SpecificationDraft v0.1–v0.3 published. Next: iterate v0.x ahead of v1.0 stabilization.in progress
Registry & versioningLive — jurisdiction-grouped, versioned, deterministic dotted paths.done
Verification practicePractices documented — 19 schemas verified end-to-end. Next: extend verification across the rest of the registry.done
Reference schemas33 published schemas across 20 jurisdictions/vendors. Next: broaden coverage beyond the initial reference set.in progress
GovernanceFoundation, open-source, publicly versioned.done

DealerSchema is founded by Pitlane and built to be governed as an open foundation. More dealers, more vendors, and more jurisdictions make the standard better. If you work on dealer agents, or you own a piece of dealer infrastructure, review the registry and propose a schema.