{
  "spec_version": "3",
  "endpoint": "api-manifest",
  "content_lang": "ja",
  "meta_lang": "en",
  "canonical_url": "https://the-shashi.com/api/",
  "api_url": "/api/api-manifest.json",
  "updated": "2026-09-07",
  "license": "© 2026 Yutaka Sugiura. All rights reserved.",
  "attribution": "The社史 (the-shashi.com) — https://the-shashi.com/api/",
  "version": "3",
  "base": "https://the-shashi.com",
  "endpoints": [
    {
      "id": "companies",
      "path": "/api/companies.json",
      "label": "All companies + public endpoint catalog",
      "description": "Public entry point. Endpoint catalog + a minimal index of every public company (stock_code / name / name_en / industry / industry_detail).",
      "scope": "global",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "decisions-index",
      "path": "/api/decisions.json",
      "label": "All management decisions",
      "description": "Every management decision across all companies — company, title, year, type and the page URL. Holds no body text; follow html_url to read one.",
      "scope": "global",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "api-manifest",
      "path": "/api/api-manifest.json",
      "label": "Endpoint definitions",
      "description": "Definition of every public endpoint (id / path / scope / format).",
      "scope": "global",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "company",
      "path": "/api/{stock_code}/company.json",
      "label": "Company index",
      "description": "Company profile plus the index of this company's pages (html_url) and APIs (api_url). Holds no body text.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "ceo",
      "path": "/api/{stock_code}/ceo.json",
      "label": "Past presidents",
      "description": "Every president in company history — tenure, background, career table, quotes and the four-frame account of each tenure.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "history",
      "path": "/api/{stock_code}/history.json",
      "label": "History and decisions",
      "description": "Chaptered history essay + long-term results from founding to present + the management decisions with their page URLs.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials",
      "path": "/api/{stock_code}/financials.json",
      "label": "Financial statements",
      "description": "Entry point for the financials — the last three years of PL / BS / CF, plus the api_url of every section below and the page it belongs to.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials-segment",
      "path": "/api/{stock_code}/financials/segment.json",
      "label": "Revenue split",
      "description": "Ten-year revenue split on three axes — reporting segment, geographic region and the disclosed product / customer mix.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials-pl",
      "path": "/api/{stock_code}/financials/pl.json",
      "label": "Profit and loss",
      "description": "Ten-year profit and loss statement — sales, costs and profit at every stage.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials-bs",
      "path": "/api/{stock_code}/financials/bs.json",
      "label": "Balance sheet",
      "description": "Ten-year balance sheet — assets, equity and interest-bearing debt with its breakdown.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials-cf",
      "path": "/api/{stock_code}/financials/cf.json",
      "label": "Cash flow",
      "description": "Ten-year cash flow statement — operating, investing and financing cash flow and the closing cash balance.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials-employee",
      "path": "/api/{stock_code}/financials/employee.json",
      "label": "Workforce",
      "description": "Ten-year workforce data — headcount consolidated and parent-only, average pay, age and length of service.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials-stock",
      "path": "/api/{stock_code}/financials/stock.json",
      "label": "Shares and market data",
      "description": "Ten-year share data — shares outstanding, closing price, market capitalisation, EPS, PER and PBR.",
      "scope": "company",
      "format": "json",
      "method": "GET"
    },
    {
      "id": "financials-csv",
      "path": "/api/{stock_code}/financials.csv",
      "label": "Financials CSV",
      "description": "Annual financial data as CSV (reference; JSON recommended)",
      "scope": "company",
      "format": "csv",
      "method": "GET"
    },
    {
      "id": "financials-history-csv",
      "path": "/api/{stock_code}/financials_history.csv",
      "label": "Long-term results CSV",
      "description": "Long-term performance as CSV (reference; JSON recommended)",
      "scope": "company",
      "format": "csv",
      "method": "GET"
    }
  ]
}