# Common Sense Systems API

Plain-text orientation for agents. The canonical API contract is the generated OpenAPI document.

## Canonical Contract

- API base URL: https://api.common-sense.com/v1
- OpenAPI: https://api.common-sense.com/openapi.json
- OpenAPI alias for /v1-base clients: https://api.common-sense.com/v1/openapi.json
- Docs: https://api.common-sense.com/docs
- Health: https://api.common-sense.com/health and https://api.common-sense.com/v1/health
- Capabilities: GET /v1/capabilities

## Authority & Freshness

For anything that can change (prices, availability, offers, checkout), this API and the live website service pages / JSON-LD are authoritative and current. Search-engine snippets and cached copies are NON-authoritative and possibly stale — do not quote a price from a snippet; read GET /v1/services or GET /v1/services/{serviceId}.

Stale reads cannot complete a purchase: checkout echoes a `purchaseDigest` and returns `409 OFFER_CHANGED` on drift (refetch and retry). To detect a stale copy, compare the build-stamp — a short content version, not a timestamp (same release => same value): GET /v1/health (field: `build_stamp`), or the website's https://common-sense.com/build-stamp.txt. If it differs from the value your cached data was captured under, refetch.

## Business

- Name: Common Sense Systems
- Description: Common Sense Systems, Inc. is a Kirkland, WA consulting firm, founded in 1996, that helps organizations find and remove the constraint limiting their performance through the Theory of Constraints, systems engineering, and modern AI.
- Website: https://common-sense.com
- Email: john@common-sense.com
- Phone: +14259792282

## Capability Areas

- Theory of Constraints analysis for cross-team operational constraints, offer, and messaging strategy
- Local LLM deployment and AI-assisted analysis where data, control, or context should remain local
- JSON-LD and structured-data implementation and audit work
- GA4 and Search Console analysis, paired with web-scraping diagnostics for local-business visibility
- Embedded systems work, including RTOS and device-driver work, with FDA design-control context for medical devices
- A public agent-facing API with generated OpenAPI, current offer data, and a guarded checkout flow

## Fit

- A good fit if a persistent problem crosses teams, the limiting factor is unclear, or analysis must lead to a practical technical or operational next step.
- Not a good fit if you need generic high-volume marketing production, a prepackaged transformation program, or confirmation of a decision already made.

## Public Endpoints

- GET /v1/business
- GET /v1/business/credentials
- GET /v1/services
- GET /v1/services/categories
- GET /v1/services/{serviceId}
- GET /v1/services/{serviceId}/faq
- GET /v1/services/{serviceId}/testimonials
- POST /v1/services/{serviceId}/checkout
- GET /v1/checkout/{token}
- GET /v1/reports/{token}
- POST /v1/inquiries
- GET /v1/insights
- GET /v1/insights/search
- GET /v1/insights/{insightId}
- GET /v1/knowledge/toc-principles

## Checkout Model

Public reads and self-serve checkout initiation take no API key. An agent may initiate checkout for services whose `ctaType` is `stripe`; the human buyer completes payment at Stripe. Before checkout, read `buyerInputSchema` and `purchaseDigest` from GET /v1/services/{serviceId}. Send `buyerInputs` satisfying that schema and echo `purchaseDigest`; `409 OFFER_CHANGED` means refetch the service and retry. Human-led services are not bought through checkout.

## Current Active Services

- `consulting-session` — One-Hour Working Session
  price: USD $150
  ctaType: `stripe`; pricing.model: `fixed_stripe`
  acquisition: self-serve checkout: POST /v1/services/consulting-session/checkout
  purchaseDigest: `pd:8be87593feba637a91073b135f0255377caecfeee8297c3381a541d6405a5f04`
  required buyerInputs: none
  accepted buyerInputs: none
- `detailed-tactics` — Detailed Tactics
  price: USD $2,500
  ctaType: `stripe`; pricing.model: `fixed_stripe`
  acquisition: self-serve checkout: POST /v1/services/detailed-tactics/checkout
  purchaseDigest: `pd:e60ddfd1eff64f3d830c15119d045ace1fcbd443396dce68280baa89aa1169f0`
  required buyerInputs: none
  accepted buyerInputs: none
- `embedded-safety-critical-review` — Embedded & Safety-Critical Systems Review
  price: USD from $2,750
  ctaType: `calendar`; pricing.model: `custom_quote`
  acquisition: human-led: use the service page, contact form, or published booking link
  purchaseDigest: `pd:8f8bc4da11e3813f5b1a21f364ce064b3070dd21d9317e1c2d04771467460408`
  required buyerInputs: none
  accepted buyerInputs: none
- `gbp-audit` — Google Business Profile Audit
  price: USD $39.99
  ctaType: `stripe`; pricing.model: `fixed_stripe`
  acquisition: self-serve checkout: POST /v1/services/gbp-audit/checkout
  purchaseDigest: `pd:533d00a6a683b7257ec98eba6ada2748207975b190657f410d76f5694dc98c1d`
  required buyerInputs: responsibility_acknowledged
  accepted buyerInputs: responsibility_acknowledged, business_name, location, place_id, website_url, competitors
  alternative buyerInput requirements: place_id or business_name + location
- `going-forward-strategy` — Going-Forward Strategy
  price: USD $2,500
  ctaType: `stripe`; pricing.model: `fixed_stripe`
  acquisition: self-serve checkout: POST /v1/services/going-forward-strategy/checkout
  purchaseDigest: `pd:8f7669f72b1d9f5c58408b5d15eb99ec788b6a301f03e88904ca12da92b8a1a5`
  required buyerInputs: none
  accepted buyerInputs: none
- `jsonld-audit` — JSON-LD Schema Audit & Implementation Guide
  price: USD $39.99
  ctaType: `stripe`; pricing.model: `fixed_stripe`
  acquisition: self-serve checkout: POST /v1/services/jsonld-audit/checkout
  purchaseDigest: `pd:39a4ad8d50762b6fdb00bcafb2843518f63f8a52c63de6c35f247eb4f78c0667`
  required buyerInputs: responsibility_acknowledged, url_to_audit
  accepted buyerInputs: responsibility_acknowledged, url_to_audit
- `offer-messaging-clarity-audit` — Offer Messaging & Clarity Audit
  price: USD $1,750
  ctaType: `calendar`; pricing.model: `fixed_meeting`
  acquisition: human-led: use the service page, contact form, or published booking link
  purchaseDigest: `pd:3287a9d6769417be40f603a27f78c929d324b90062719b9bcd28a6a0a0424cf7`
  required buyerInputs: none
  accepted buyerInputs: none
- `problem-diagnosis` — Problem Diagnosis
  price: USD $2,500
  ctaType: `stripe`; pricing.model: `fixed_stripe`
  acquisition: self-serve checkout: POST /v1/services/problem-diagnosis/checkout
  purchaseDigest: `pd:96d694344c585b41bcb93ec5982f0a2d7ff088449b263dcc81466fd34d259772`
  required buyerInputs: none
  accepted buyerInputs: none