Skip to content

API

Common Sense Systems API

A machine-readable interface for the business. Human-friendly, under development, and documented at the service edge.

Browse Docs OpenAPI Spec Health Check

What this page is for

This is the human entry point for the Common Sense Systems API. The service is still in development, but the shape is already useful: a business-facing API for services, insights, availability, and company facts.

If you are evaluating the API, start with the OpenAPI spec. If you are just trying to understand what is there, use the endpoint browser below.

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 /health

    Service status and timestamp.

  • GET /capabilities

    Categories, counts, and supported operations.

  • GET /business

    Company profile and public facts.

Services

Structured service catalog data for the consulting offer.

  • GET /services

    List the current services.

  • GET /services/{serviceId}

    Fetch one service and its details.

  • GET /services/{serviceId}/testimonials

    Client quotes tied to a service.

  • GET /services/{serviceId}/faq

    Common questions and answers for a service.

Insights

Content discovery and search for the public knowledge base.

  • GET /insights

    Browse recent insight entries.

  • GET /insights/{insightId}

    Fetch one insight in detail.

  • GET /insights/search

    Search insight content by topic or keyword.

  • GET /knowledge/toc-principles

    TOC principle reference for integrations and tools.

Operations

Inquiry capture and scheduling helpers for real conversations.

  • GET /availability

    Current availability and response time.

  • POST /availability/book

    Schedule a consultation request.

  • POST /inquiries

    Submit an inquiry and track it.

For humans

Use the spec first, then inspect the response shape.

The page is deliberately plain: it should help a person orient quickly, and it should not pretend the API is more finished than it is. If you need to integrate it, the OpenAPI document is the source of truth.

Need help integrating the API?

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

OpenAPI Spec Contact Us