{
 "openapi": "3.1.0",
 "info": {
  "title": "Annalist static API",
  "version": "v1",
  "description": "Company fundamentals from official filings, published as versioned snapshots. Every figure carries the id of its source document. Read-only, no authentication. An MCP server with the same data is at /mcp (Streamable HTTP). Clients send a User-Agent header of their own. The hosting service answers HTTP 403 (Cloudflare error 1010) to requests whose User-Agent starts with Python-urllib, the default of the Python standard library, or with libwww-perl; the MCP Python SDK, requests, httpx, curl and browsers need no change. Figures come from official filings and are provided as they are, without warranty of accuracy or completeness. They are not investment advice.",
  "termsOfService": "https://annalist.io/terms/",
  "contact": {
   "name": "Annalist",
   "url": "https://annalist.io/about/"
  }
 },
 "servers": [
  {
   "url": "https://annalist.io"
  }
 ],
 "paths": {
  "/api/v1/companies.json": {
   "get": {
    "operationId": "listCompanies",
    "summary": "Company universe with each latest snapshot",
    "parameters": [],
    "responses": {
     "200": {
      "description": "Company universe with each latest snapshot",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/CompanyList"
        },
        "example": {
         "companies": [
          {
           "id": "apple",
           "name": "Apple Inc.",
           "country": "US",
           "template": "corporate",
           "cik": "0000320193",
           "tickers": [
            "AAPL"
           ],
           "sources": "10-K and 10-Q filings with the SEC, published by SEC EDGAR",
           "latest": {
            "snapshot": "FY2026Q3_7b3a2a41",
            "as_of": {
             "period": "FY2026 Q3",
             "period_end": "2026-06-27",
             "release_date": "2026-07-31"
            },
            "published_at": "2026-10-22T13:14:28+00:00",
            "url": "/api/v1/companies/apple/latest.json",
            "snapshots": "/api/v1/companies/apple/snapshots.json",
            "info": "/api/v1/companies/apple/snapshots/FY2026Q3_7b3a2a41/info.json",
            "statements": [
             "balance_sheet",
             "cash_flow",
             "income_statement"
            ],
            "ratios": "/api/v1/companies/apple/snapshots/FY2026Q3_7b3a2a41/ratios/index.json",
            "findings": "/api/v1/companies/apple/findings.json",
            "checks": 261,
            "checks_failed": 0
           }
          }
         ]
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/overview.json": {
   "get": {
    "operationId": "getOverview",
    "summary": "Every company with its latest revenue and net income, the latest value of each measure of the directory, its peers, and the definitions of the measures",
    "parameters": [],
    "responses": {
     "200": {
      "description": "Every company with its latest revenue and net income, the latest value of each measure of the directory, its peers, and the definitions of the measures",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/quality.json": {
   "get": {
    "operationId": "getDataQuality",
    "summary": "Data quality of each company, with the meaning of each measure",
    "parameters": [],
    "responses": {
     "200": {
      "description": "Data quality of each company, with the meaning of each measure",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/latest.json": {
   "get": {
    "operationId": "getLatestSnapshot",
    "summary": "Pointer to the latest snapshot",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     }
    ],
    "responses": {
     "200": {
      "description": "Pointer to the latest snapshot",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Latest"
        },
        "example": {
         "company": "apple",
         "snapshot": "FY2026Q3_7b3a2a41",
         "as_of": {
          "period": "FY2026 Q3",
          "period_end": "2026-06-27",
          "release_date": "2026-07-31"
         },
         "dataset_sha256": "7b3a2a418bd05d7d27622324b23f24e602aad8fc13b0450bf8be842aa1864d09",
         "published_at": "2026-10-22T13:14:28+00:00",
         "info": "/api/v1/companies/apple/snapshots/FY2026Q3_7b3a2a41/info.json",
         "dataset": "/api/v1/companies/apple/snapshots/FY2026Q3_7b3a2a41/dataset.json",
         "snapshots": "/api/v1/companies/apple/snapshots.json"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots.json": {
   "get": {
    "operationId": "listSnapshots",
    "summary": "Every snapshot the site has published for the company, with the time of each publication (point in time)",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     }
    ],
    "responses": {
     "200": {
      "description": "Every snapshot the site has published for the company, with the time of each publication (point in time)",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/findings.json": {
   "get": {
    "operationId": "getFindings",
    "summary": "Key findings with their append-only history (states, change types, rules)",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     }
    ],
    "responses": {
     "200": {
      "description": "Key findings with their append-only history (states, change types, rules)",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Findings"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/info.json": {
   "get": {
    "operationId": "getSnapshotInfo",
    "summary": "Snapshot summary",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     }
    ],
    "responses": {
     "200": {
      "description": "Snapshot summary",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/SnapshotInfo"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/statements/{section}.json": {
   "get": {
    "operationId": "getStatement",
    "summary": "One statement with its item definitions",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     },
     {
      "name": "section",
      "in": "path",
      "required": true,
      "example": "pl_annual",
      "schema": {
       "type": "string",
       "enum": [
        "pl_quarterly",
        "pl_annual",
        "balance_sheet",
        "cf_quarterly",
        "cf_annual",
        "capital",
        "npl",
        "shares",
        "annual_highlights"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "One statement with its item definitions",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Statement"
        },
        "example": {
         "company": "apple",
         "snapshot": "FY2026Q3_7b3a2a41",
         "statement": "income_statement",
         "frequency": "annual",
         "section": "pl_annual",
         "as_of": {
          "period": "FY2026 Q3",
          "period_end": "2026-06-27",
          "release_date": "2026-07-31"
         },
         "items": {
          "revenue": {
           "label": "Revenue",
           "unit": "USD",
           "additive": true,
           "group": "statement"
          }
         },
         "rows": [
          {
           "fiscal_year": 2025,
           "start": "2024-09-29",
           "end": "2025-09-27",
           "through": "FY2025 Q4",
           "complete": true,
           "sources": [
            "10-K:0000320193-25-000079"
           ],
           "method": "reported",
           "values": {
            "revenue": 416161000000.0
           },
           "value_sources": {
            "revenue": [
             "10-K:0000320193-25-000079"
            ]
           }
          }
         ]
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/documents.json": {
   "get": {
    "operationId": "getDocuments",
    "summary": "Source documents",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     }
    ],
    "responses": {
     "200": {
      "description": "Source documents",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Documents"
        },
        "example": {
         "company": "apple",
         "snapshot": "FY2026Q3_7b3a2a41",
         "documents": {
          "10-K:0000320193-20-000096": {
           "kind": "filing",
           "form": "10-K",
           "accession": "0000320193-20-000096",
           "report_date": "2020-09-26",
           "filed": "2020-10-30",
           "fiscal_period": "FY2020 FY",
           "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/aapl-20200926.htm",
           "index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019320000096/"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/calendar.json": {
   "get": {
    "operationId": "getCalendar",
    "summary": "The calendar quarter of each fiscal period of the snapshot, by which companies with different fiscal years are compared",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     }
    ],
    "responses": {
     "200": {
      "description": "The calendar quarter of each fiscal period of the snapshot, by which companies with different fiscal years are compared",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        },
        "example": {
         "company": "apple",
         "snapshot": "FY2026Q3_7b3a2a41",
         "as_of": {
          "period": "FY2026 Q3",
          "period_end": "2026-06-27",
          "release_date": "2026-07-31"
         },
         "periods": {
          "FY2026 Q2": {
           "quarter": "CY2026 Q1",
           "quarter_end": "2026-03-31",
           "end": "2026-03-28"
          },
          "FY2026 Q3": {
           "quarter": "CY2026 Q2",
           "quarter_end": "2026-06-30",
           "end": "2026-06-27"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/ratios/index.json": {
   "get": {
    "operationId": "getRatioCatalogue",
    "summary": "Ratio catalogue and frequencies",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     }
    ],
    "responses": {
     "200": {
      "description": "Ratio catalogue and frequencies",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/ratios/series.json": {
   "get": {
    "operationId": "getRatioSeries",
    "summary": "Every ratio of the snapshot as a compact time series by frequency, with its name, category and unit",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     }
    ],
    "responses": {
     "200": {
      "description": "Every ratio of the snapshot as a compact time series by frequency, with its name, category and unit",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/ratios/{frequency}.json": {
   "get": {
    "operationId": "getRatios",
    "summary": "Ratio values of one frequency with their inputs, and the parts of scores, credit reconciliations and the liquidity cover",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     },
     {
      "name": "frequency",
      "in": "path",
      "required": true,
      "example": "ttm",
      "schema": {
       "type": "string",
       "enum": [
        "annual",
        "quarterly",
        "ttm"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Ratio values of one frequency with their inputs, and the parts of scores, credit reconciliations and the liquidity cover",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/RatioValues"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/dataset.json": {
   "get": {
    "operationId": "getDataset",
    "summary": "Full dataset (schema annalist.dataset/0.1)",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     }
    ],
    "responses": {
     "200": {
      "description": "Full dataset (schema annalist.dataset/0.1)",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/model_inputs.json": {
   "get": {
    "operationId": "getModelInputs",
    "summary": "Deal Lab: the published figures that the models of the company take from the snapshot, with their methods and source documents (schema annalist.model_inputs/1.0)",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     }
    ],
    "responses": {
     "200": {
      "description": "Deal Lab: the published figures that the models of the company take from the snapshot, with their methods and source documents (schema annalist.model_inputs/1.0)",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/deal-lab/buyout/{company}.json": {
   "get": {
    "operationId": "getBuyoutStart",
    "summary": "Deal Lab: the starting values of the buyout model 1.0 of a company, each with its origin",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     }
    ],
    "responses": {
     "200": {
      "description": "Deal Lab: the starting values of the buyout model 1.0 of a company, each with its origin",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/deal-lab/screen.json": {
   "get": {
    "operationId": "getBuyoutScreen",
    "summary": "Deal Lab: every company with every input of the buyout model, at its starting values",
    "parameters": [],
    "responses": {
     "200": {
      "description": "Deal Lab: every company with every input of the buyout model, at its starting values",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  },
  "/api/v1/companies/{company}/snapshots/{snapshot}/{table}.csv": {
   "get": {
    "operationId": "getTable",
    "summary": "Long-format CSV table described in tables.json",
    "parameters": [
     {
      "name": "company",
      "in": "path",
      "required": true,
      "description": "company id",
      "schema": {
       "type": "string",
       "enum": [
        "mizuho",
        "amazon",
        "walmart",
        "unitedhealth",
        "apple",
        "alphabet",
        "cvs-health",
        "berkshire-hathaway",
        "mckesson",
        "exxon-mobil",
        "cencora",
        "nvidia",
        "microsoft",
        "spacex",
        "anthropic",
        "meta-platforms",
        "broadcom",
        "tesla",
        "eli-lilly",
        "micron-technology",
        "amd",
        "visa",
        "johnson-and-johnson",
        "mastercard",
        "abbvie",
        "intel",
        "palantir",
        "chevron",
        "costco",
        "cisco",
        "coca-cola",
        "oracle",
        "procter-and-gamble",
        "merck",
        "caterpillar",
        "lam-research",
        "general-electric",
        "applied-materials",
        "philip-morris",
        "home-depot",
        "netflix",
        "dell",
        "palo-alto-networks",
        "rtx",
        "thermo-fisher",
        "texas-instruments",
        "ge-vernova",
        "amgen",
        "crowdstrike",
        "arista-networks",
        "shell",
        "astrazeneca",
        "rolls-royce",
        "rio-tinto",
        "unilever",
        "bp",
        "british-american-tobacco",
        "gsk",
        "national-grid",
        "bae-systems",
        "relx",
        "compass-group",
        "lseg",
        "anglo-american",
        "diageo",
        "coca-cola-europacific",
        "reckitt",
        "tesco",
        "haleon",
        "antofagasta",
        "sse",
        "vodafone",
        "imperial-brands",
        "bt-group",
        "ihg",
        "next",
        "associated-british-foods",
        "halma",
        "segro",
        "informa",
        "united-utilities",
        "diploma",
        "sage",
        "airtel-africa",
        "endeavour-mining",
        "severn-trent",
        "schroders",
        "intertek",
        "smith-nephew",
        "bunzl",
        "tencent",
        "petrochina",
        "midea",
        "zijin-mining",
        "united-tractors",
        "hm-sampoerna",
        "bayan-resources",
        "indoritel-makmur",
        "pantai-indah-kapuk-dua",
        "barito-renewables",
        "amman-mineral",
        "adaro-andalan",
        "chandra-asri",
        "dci-indonesia",
        "barito-pacific",
        "dian-swastatika",
        "merdeka-gold",
        "pln",
        "mind-id",
        "pupuk-indonesia",
        "ptpn-iii",
        "pelindo",
        "id-food",
        "asdp",
        "astra-international",
        "telkom-indonesia",
        "pertamina",
        "kereta-api-indonesia"
       ]
      },
      "example": "apple"
     },
     {
      "name": "snapshot",
      "in": "path",
      "required": true,
      "description": "snapshot id from latest.json, for example FY2026Q2_0a602300, or FY2025_09a11bd1 for a company that reports fiscal years only",
      "schema": {
       "type": "string",
       "pattern": "^FY[0-9]{4}(Q[1-4])?_[0-9a-f]{8}$"
      },
      "example": "FY2026Q3_7b3a2a41"
     },
     {
      "name": "table",
      "in": "path",
      "required": true,
      "example": "pl_annual",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "Long-format CSV table described in tables.json",
      "content": {
       "text/csv": {
        "schema": {
         "type": "string"
        }
       }
      }
     },
     "404": {
      "description": "not found"
     }
    }
   }
  }
 },
 "components": {
  "schemas": {
   "CompanyList": {
    "type": "object",
    "properties": {
     "companies": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Company"
      }
     }
    }
   },
   "Company": {
    "type": "object",
    "required": [
     "id",
     "name"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "country": {
      "type": "string"
     },
     "cik": {
      "type": [
       "string",
       "null"
      ]
     },
     "tickers": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "sources": {
      "type": "string"
     },
     "latest": {
      "type": [
       "object",
       "null"
      ]
     }
    }
   },
   "Latest": {
    "type": "object",
    "required": [
     "company",
     "snapshot",
     "as_of"
    ],
    "properties": {
     "company": {
      "type": "string"
     },
     "snapshot": {
      "type": "string"
     },
     "as_of": {
      "$ref": "#/components/schemas/AsOf"
     },
     "dataset_sha256": {
      "type": "string"
     },
     "info": {
      "type": "string"
     },
     "dataset": {
      "type": "string"
     }
    }
   },
   "AsOf": {
    "type": "object",
    "properties": {
     "period": {
      "type": "string"
     },
     "period_end": {
      "type": "string",
      "format": "date"
     },
     "release_date": {
      "type": [
       "string",
       "null"
      ],
      "format": "date"
     },
     "indexed": {
      "type": "string",
      "format": "date",
      "description": "for a report that states no date of publication, the date on which the index of structured reports added it; release_date is then null"
     }
    }
   },
   "SnapshotInfo": {
    "type": "object",
    "properties": {
     "snapshot": {
      "type": "string"
     },
     "as_of": {
      "$ref": "#/components/schemas/AsOf"
     },
     "conventions": {
      "type": "object"
     },
     "validation": {
      "type": "object"
     },
     "statements": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "files": {
      "type": "array",
      "items": {
       "type": "object"
      }
     },
     "citation": {
      "type": "object"
     }
    }
   },
   "Statement": {
    "type": "object",
    "required": [
     "company",
     "snapshot",
     "statement",
     "items",
     "rows"
    ],
    "properties": {
     "company": {
      "type": "string"
     },
     "snapshot": {
      "type": "string"
     },
     "statement": {
      "type": "string"
     },
     "frequency": {
      "type": "string"
     },
     "items": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "properties": {
        "label": {
         "type": "string"
        },
        "unit": {
         "type": "string"
        },
        "scope": {
         "type": "string",
         "description": "for one company, the line that gives the item where its reports name it otherwise"
        }
       }
      }
     },
     "rows": {
      "type": "array",
      "items": {
       "$ref": "#/components/schemas/Row"
      }
     }
    }
   },
   "Row": {
    "type": "object",
    "properties": {
     "period": {
      "type": "string"
     },
     "fiscal_year": {
      "type": "integer"
     },
     "quarter": {
      "type": "integer"
     },
     "start": {
      "type": "string",
      "format": "date"
     },
     "end": {
      "type": "string",
      "format": "date"
     },
     "date": {
      "type": "string",
      "format": "date"
     },
     "method": {
      "type": "string"
     },
     "values": {
      "type": "object",
      "additionalProperties": {
       "type": [
        "number",
        "null"
       ]
      }
     },
     "sources": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "value_sources": {
      "type": "object"
     },
     "value_methods": {
      "type": "object",
      "description": "reported, or derived where the figure is calculated from figures of the documents listed"
     },
     "comparison": {
      "type": "object",
      "description": "by item, the 2 figures of a change against a year earlier (value, earlier) as the latest report that presents both gives them, with their sources and the fiscal year of the report (basis), where they are not the published figures; null where no report presents both"
     }
    }
   },
   "RatioValues": {
    "type": "object",
    "required": [
     "ratios",
     "values"
    ],
    "properties": {
     "frequency": {
      "type": "string"
     },
     "template": {
      "type": "string"
     },
     "engine": {
      "type": "string"
     },
     "ratios": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "properties": {
        "name": {
         "type": "string"
        },
        "category": {
         "type": "string"
        },
        "definition": {
         "type": "string"
        },
        "meaning": {
         "type": "string"
        },
        "excluded": {
         "type": "string",
         "description": "the reason a rule leaves the ratio out for this company; the ratio then has no values"
        },
        "unit": {
         "type": "string"
        },
        "frequencies": {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        "parts": {
         "type": "object",
         "additionalProperties": {
          "type": "object",
          "properties": {
           "name": {
            "type": "string"
           },
           "coefficient": {
            "type": "number"
           },
           "side": {
            "type": "string",
            "enum": [
             "sources",
             "uses"
            ]
           },
           "meaning": {
            "type": "string"
           }
          }
         }
        }
       }
      }
     },
     "values": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "ratio",
        "period",
        "value"
       ],
       "properties": {
        "ratio": {
         "type": "string"
        },
        "frequency": {
         "type": "string"
        },
        "period": {
         "type": "string"
        },
        "end": {
         "type": [
          "string",
          "null"
         ],
         "format": "date"
        },
        "value": {
         "type": "number"
        },
        "inputs": {
         "type": "array",
         "items": {
          "type": "string"
         }
        },
        "estimates": {
         "type": "array",
         "items": {
          "type": "string"
         },
         "description": "the estimated inputs used for the value, such as the lease cost of the latest fiscal year for quarters that do not report it"
        },
        "parts": {
         "type": "object",
         "additionalProperties": {
          "type": [
           "number",
           "null"
          ]
         }
        }
       }
      }
     },
     "inputs": {
      "type": "object"
     }
    }
   },
   "Findings": {
    "type": "object",
    "required": [
     "company",
     "snapshot",
     "records"
    ],
    "properties": {
     "company": {
      "type": "string"
     },
     "snapshot": {
      "type": "string"
     },
     "findings_version": {
      "type": "string"
     },
     "conventions": {
      "type": "object"
     },
     "rules": {
      "type": "object"
     },
     "threads": {
      "type": "object"
     },
     "records": {
      "type": "array",
      "items": {
       "type": "object",
       "properties": {
        "seq": {
         "type": "integer"
        },
        "thread": {
         "type": "string"
        },
        "rule": {
         "type": "string"
        },
        "rule_version": {
         "type": "string"
        },
        "claim": {
         "type": "string"
        },
        "state": {
         "type": "string",
         "enum": [
          "New",
          "Confirmed",
          "Strengthened",
          "Weakened",
          "Retired"
         ]
        },
        "change": {
         "type": "string"
        },
        "basis": {
         "type": "string",
         "enum": [
          "recorded",
          "reconstructed"
         ]
        },
        "period": {
         "type": "string"
        },
        "period_end": {
         "type": [
          "string",
          "null"
         ]
        },
        "snapshot": {
         "type": "string"
        },
        "text": {
         "type": [
          "string",
          "null"
         ]
        },
        "reason": {
         "type": [
          "string",
          "null"
         ]
        },
        "measure": {
         "type": [
          "object",
          "null"
         ]
        },
        "figures": {
         "type": "array",
         "items": {
          "type": "object"
         }
        }
       }
      }
     }
    }
   },
   "Documents": {
    "type": "object",
    "properties": {
     "documents": {
      "type": "object",
      "additionalProperties": {
       "type": "object",
       "properties": {
        "url": {
         "type": [
          "string",
          "null"
         ]
        },
        "sha256": {
         "type": "string"
        },
        "release_date": {
         "type": [
          "string",
          "null"
         ]
        },
        "filed": {
         "type": [
          "string",
          "null"
         ]
        },
        "indexed": {
         "type": "string",
         "description": "the date on which the index of structured reports added a report that states no date of publication"
        },
        "store": {
         "type": "string",
         "description": "the official store of the filing, whose terms allow a link to its home page only; url is then that page"
        }
       }
      }
     }
    }
   }
  }
 }
}
