Figurewell

{
  "type": "object",
  "required": [
    "ticker"
  ],
  "properties": {
    "cik": {
      "type": "string",
      "description": "SEC CIK number, for companies without a listed ticker"
    },
    "form": {
      "enum": [
        "all",
        "annual",
        "quarterly"
      ],
      "type": "string",
      "default": "all",
      "description": "all, annual (10-K, 20-F, 40-F) or quarterly (10-Q)"
    },
    "as_of": {
      "type": "string",
      "examples": [
        "2024-06-30"
      ],
      "description": "Point in time: only filings EDGAR had accepted by then. YYYY-MM-DD (end of day, New York) or ISO time with offset. Empty = now"
    },
    "limit": {
      "type": "integer",
      "default": 8,
      "description": "Filings, newest accepted first (1-40)"
    },
    "fields": {
      "type": "string",
      "description": "Only these metrics (comma separated): revenue, cost_of_revenue, gross_profit, operating_income, net_income, eps_basic, eps_diluted, diluted_shares, total_assets, current_assets, total_liabilities, current_liabilities, stockholders_equity, cash, long_term_debt, operating_cash_flow_ytd, capex_ytd, dividends_paid_ytd, free_cash_flow_ytd, gross_margin, net_margin"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "description": "Skip filings (paging)"
    },
    "ticker": {
      "type": "string",
      "examples": [
        "AAPL"
      ],
      "description": "Stock ticker (e.g. AAPL). Or pass \"\" and use cik"
    },
    "amendments": {
      "type": "boolean",
      "default": false,
      "description": "Include 10-K/A and 10-Q/A amendments (default false)"
    }
  }
}

{
  "type": "object",
  "required": [
    "ticker"
  ],
  "properties": {
    "as_of": {
      "type": "string",
      "description": "Only what was public by then (YYYY-MM-DD or ISO time)"
    },
    "limit": {
      "type": "integer",
      "default": 12,
      "description": "Periods, newest first (1-80)"
    },
    "metric": {
      "enum": [
        "revenue",
        "cost_of_revenue",
        "gross_profit",
        "operating_income",
        "net_income",
        "eps_basic",
        "eps_diluted",
        "diluted_shares",
        "total_assets",
        "current_assets",
        "total_liabilities",
        "current_liabilities",
        "stockholders_equity",
        "cash",
        "long_term_debt",
        "operating_cash_flow_ytd",
        "capex_ytd",
        "dividends_paid_ytd"
      ],
      "type": "string",
      "default": "revenue",
      "examples": [
        "revenue"
      ],
      "description": "One of: revenue, cost_of_revenue, gross_profit, operating_income, net_income, eps_basic, eps_diluted, diluted_shares, total_assets, current_assets, total_liabilities, current_liabilities, stockholders_equity, cash, long_term_debt, operating_cash_flow_ytd, capex_ytd, dividends_paid_ytd"
    },
    "period": {
      "enum": [
        "quarter",
        "annual",
        "ytd",
        "instant"
      ],
      "type": "string",
      "description": "quarter, annual, ytd or instant (default: the metric's own kind)"
    },
    "ticker": {
      "type": "string",
      "examples": [
        "AAPL"
      ],
      "description": "Stock ticker (or pass \"\" and use cik)"
    }
  }
}

{
  "type": "object",
  "required": [
    "tickers"
  ],
  "properties": {
    "form": {
      "enum": [
        "all",
        "annual",
        "quarterly"
      ],
      "type": "string",
      "default": "all",
      "description": "all, annual or quarterly"
    },
    "as_of": {
      "type": "string",
      "examples": [
        "2023-01-31"
      ],
      "description": "Point in time (YYYY-MM-DD = end of that day, New York). Empty = now"
    },
    "tickers": {
      "type": "string",
      "examples": [
        "AAPL,MSFT,NVDA"
      ],
      "description": "Up to 10 tickers, comma separated (or pass \"\" and use cik)"
    }
  }
}