Build with Parity — carefully

SAMPLE API curl examples · 4 recipes · OpenAPI 0.2.0-local+stub

SAMPLE curl deepen on /developers — OpenAPI stub, health probe, and quote-search sketch.

Copy a SAMPLE curl, hit localhost stubs, and read unimplemented honesty — then open /api/v1 for the human roadmap.

• Ops health probe

  SAMPLE · liveness JSON — ok, version, waves. No secrets.

  GET /api/health

  curl -sS http://localhost:3000/api/health | jq .

  Copy curl

  {
    "ok": true,
    "version": "14.0.0",
    "waves": 350,
    "checkedAt": "2026-09-28T12:00:00.000Z",
    "service": "parity"
  }

• OpenAPI 3 stub

  SAMPLE · machine-readable future surface — marked unimplemented.

  GET /api/v1/openapi.json

  curl -sS http://localhost:3000/api/v1/openapi.json | jq '.info'

  Copy curl

  {
    "title": "Parity API (stub)",
    "version": "0.2.0-local+stub",
    "description": "SAMPLE unimplemented partner surface"
  }

• Quotes search sketch

  SAMPLE · future quotes search — expect 501 / unimplemented_stub today.

  GET /api/v1/quotes

  curl -sS "http://localhost:3000/api/v1/quotes?line=auto&zip=75201" \
    -H "Accept: application/json"

  Copy curl

  {
    "ok": false,
    "code": "unimplemented_stub",
    "status": 501,
    "message": "SAMPLE — quotes search is a roadmap stub in this build",
    "docs": "/api/v1"
  }

• Webhook events catalog

  SAMPLE · partner webhook event types page (HTML) + docs link.

  GET /developers/webhooks

  curl -sS -o /dev/null -w "%{http_code}" http://localhost:3000/developers/webhooks

  Copy curl

  200
  # Then open /developers/webhooks for SAMPLE event JSON copies.

SAMPLE public API curl examples — commands hit demo stub routes that return unimplemented / 501-style payloads. Not live partner credentials, not a production API, and not licensed insurance distribution.