Skip to content

API

Common Sense Systems API

A machine-readable interface for public business discovery, service lookup, Insights, inquiries, and checkout handoffs.

Browse Docs OpenAPI Spec Health Check

What this page is for

This is the human entry point for the Common Sense Systems API: a public, structured way to read business facts, browse services, inspect Insights, and start inquiry or checkout handoffs.

Agents should start with OpenAPI for the exact contract, then use the public read endpoints for discovery. The checkout endpoint creates a Stripe-hosted payment URL; a human still completes payment at Stripe.

The site also publishes llms.txt for compact orientation, but OpenAPI is the authoritative API surface.

Quick start

The health endpoint is the fastest way to confirm the API is reachable. 

curl https://api.common-sense.com/v1/health

{
  "status": "healthy",
  "timestamp": "2026-06-03T15:00:00Z",
  "version": "1.0.0"
}
Endpoints

Browse the surface

Grouped by the kinds of questions the API answers.

Discovery

Start here if you want to know whether the service is alive and what it can do.

  • GET /v1/capabilities

    Get Capabilities

  • GET /v1/health

    Check Health

  • POST /v1/services/{serviceId}/checkout

    Create Service Checkout

Services

Structured service catalog data and the self-serve checkout handoff.

  • GET /v1/services

    List Services

  • GET /v1/services/categories

    List Service Categories

  • GET /v1/services/{serviceId}

    Get Service Detail

  • GET /v1/services/{serviceId}/faq

    Get Service Faq

  • GET /v1/services/{serviceId}/testimonials

    Get Service Testimonials

Insights

Content discovery and search for the public knowledge base.

  • GET /v1/insights

    List Insights

  • GET /v1/insights/search

    Search Insights

  • GET /v1/insights/{insightId}

    Get Insight Detail

  • GET /v1/knowledge/toc-principles

    Get Toc Principles

Business and inquiries

Public company facts and inquiry capture for real conversations.

  • GET /v1/business

    Get Business Profile

  • GET /v1/business/credentials

    Get Business Credentials

  • POST /v1/inquiries

    Submit Inquiry

For humans

Use the spec first, then inspect the response shape.

The page is deliberately plain: it should help a person orient quickly while keeping the generated OpenAPI document as the source of truth. Public reads expose business facts, services, and Insights; checkout initiation returns a hosted Stripe URL for a human buyer to complete.

Need help integrating the API?

Start with the OpenAPI spec. If you need a conversation about fit, integration scope, checkout handoff, or the data model, use the contact page.

OpenAPI Spec Contact Us