{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bigdata/json-schema/bigdata-key-metrics-ttmresponse-schema.json",
  "title": "KeyMetricsTTMResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bigdata-financials-ratios-api-openapi.yml#/components/schemas/KeyMetricsTTMResponse",
  "properties": {
    "results": {
      "items": {
        "$ref": "#/$defs/KeyMetricsTTM"
      },
      "type": "array",
      "title": "Results"
    },
    "errors": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/ErrorDetail"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Errors"
    },
    "metadata": {
      "anyOf": [
        {
          "$ref": "#/$defs/Metadata"
        },
        {
          "type": "null"
        }
      ]
    },
    "sources": {
      "items": {
        "$ref": "#/$defs/Source"
      },
      "type": "array",
      "title": "Sources",
      "description": "The content catalog sources the response was built from, one entry per source. Empty when no catalog source contributed."
    },
    "usage": {
      "anyOf": [
        {
          "$ref": "#/$defs/Usage"
        },
        {
          "type": "null"
        }
      ],
      "description": "Tokens the request consumed, per content tier. Present only for API keys billed in tokens."
    }
  },
  "type": "object",
  "required": [
    "results"
  ],
  "$defs": {
    "ErrorDetail": {
      "properties": {
        "message": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Message"
        }
      },
      "type": "object",
      "title": "ErrorDetail"
    },
    "KeyMetricsTTM": {
      "properties": {
        "rp_entity_id": {
          "type": "string",
          "title": "Rp Entity Id",
          "description": "RavenPack internal entity identifier."
        },
        "target_identifier_id": {
          "type": "string",
          "title": "Target Identifier Id",
          "description": "The target identifier provided in the request, e.g., stock symbol."
        },
        "market_cap": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Market Cap",
          "description": "The market cap of the company."
        },
        "enterprise_value_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Enterprise Value Ttm",
          "description": "The enterprise value of the company."
        },
        "ev_to_sales_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ev To Sales Ttm",
          "description": "The EV/Sales ratio of the company."
        },
        "ev_to_operating_cash_flow_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ev To Operating Cash Flow Ttm",
          "description": "The EV/Operating Cash Flow ratio of the company."
        },
        "ev_to_free_cash_flow_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ev To Free Cash Flow Ttm",
          "description": "The EV/Free Cash Flow ratio of the company."
        },
        "ev_to_ebitda_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ev To Ebitda Ttm",
          "description": "The EV/EBITDA ratio of the company."
        },
        "net_debt_to_ebitda_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Net Debt To Ebitda Ttm",
          "description": "The Net Debt/EBITDA ratio of the company."
        },
        "current_ratio_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Current Ratio Ttm",
          "description": "The Current Ratio of the company."
        },
        "income_quality_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Income Quality Ttm",
          "description": "The Income Quality of the company."
        },
        "graham_number_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Graham Number Ttm",
          "description": "The Graham Number of the company."
        },
        "graham_net_net_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Graham Net Net Ttm",
          "description": "The Graham Net Net of the company."
        },
        "tax_burden_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tax Burden Ttm",
          "description": "The Tax Burden of the company."
        },
        "interest_burden_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Interest Burden Ttm",
          "description": "The Interest Burden of the company."
        },
        "working_capital_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Working Capital Ttm",
          "description": "The Working Capital of the company."
        },
        "invested_capital_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Invested Capital Ttm",
          "description": "The Invested Capital of the company."
        },
        "return_on_assets_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Return On Assets Ttm",
          "description": "The Return on Assets of the company."
        },
        "operating_return_on_assets_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Operating Return On Assets Ttm",
          "description": "The Operating Return on Assets of the company."
        },
        "return_on_tangible_assets_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Return On Tangible Assets Ttm",
          "description": "The Return on Tangible Assets of the company."
        },
        "return_on_equity_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Return On Equity Ttm",
          "description": "The Return on Equity of the company."
        },
        "return_on_invested_capital_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Return On Invested Capital Ttm",
          "description": "The Return on Invested Capital of the company."
        },
        "return_on_capital_employed_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Return On Capital Employed Ttm",
          "description": "The Return on Capital Employed of the company."
        },
        "earnings_yield_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Earnings Yield Ttm",
          "description": "The Earnings Yield of the company."
        },
        "free_cash_flow_yield_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Free Cash Flow Yield Ttm",
          "description": "The Free Cash Flow Yield of the company."
        },
        "capex_to_operating_cash_flow_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Capex To Operating Cash Flow Ttm",
          "description": "The Capex to Operating Cash Flow of the company."
        },
        "capex_to_depreciation_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Capex To Depreciation Ttm",
          "description": "The Capex to Depreciation of the company."
        },
        "capex_to_revenue_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Capex To Revenue Ttm",
          "description": "The Capex to Revenue of the company."
        },
        "sales_general_and_admin_to_revenue_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sales General And Admin To Revenue Ttm",
          "description": "The Sales General and Admin to Revenue of the company."
        },
        "research_and_development_to_revenue_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Research And Development To Revenue Ttm",
          "description": "The Research and Development to Revenue of the company."
        },
        "stock_based_compensation_to_revenue_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Stock Based Compensation To Revenue Ttm",
          "description": "The Stock Based Compensation to Revenue of the company."
        },
        "intangibles_to_total_assets_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Intangibles To Total Assets Ttm",
          "description": "The Intangibles to Total Assets of the company."
        },
        "average_receivables_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Average Receivables Ttm",
          "description": "The Average Receivables of the company."
        },
        "average_payables_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Average Payables Ttm",
          "description": "The Average Payables of the company."
        },
        "average_inventory_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Average Inventory Ttm",
          "description": "The Average Inventory of the company."
        },
        "days_of_sales_outstanding_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Days Of Sales Outstanding Ttm",
          "description": "The Days of Sales Outstanding of the company."
        },
        "days_of_payables_outstanding_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Days Of Payables Outstanding Ttm",
          "description": "The Days of Payables Outstanding of the company."
        },
        "days_of_inventory_outstanding_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Days Of Inventory Outstanding Ttm",
          "description": "The Days of Inventory Outstanding of the company."
        },
        "operating_cycle_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Operating Cycle Ttm",
          "description": "The Operating Cycle of the company."
        },
        "cash_conversion_cycle_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Cash Conversion Cycle Ttm",
          "description": "The Cash Conversion Cycle of the company."
        },
        "free_cash_flow_to_equity_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Free Cash Flow To Equity Ttm",
          "description": "The Free Cash Flow to Equity of the company."
        },
        "free_cash_flow_to_firm_ttm": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Free Cash Flow To Firm Ttm",
          "description": "The Free Cash Flow to Firm of the company."
        },
        "tangible_asset_value_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Tangible Asset Value Ttm",
          "description": "The Tangible Asset Value of the company."
        },
        "net_current_asset_value_ttm": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Net Current Asset Value Ttm",
          "description": "The Net Current Asset Value of the company."
        }
      },
      "type": "object",
      "required": [
        "rp_entity_id",
        "target_identifier_id"
      ],
      "title": "KeyMetricsTTM"
    },
    "Metadata": {
      "properties": {
        "request_id": {
          "type": "string",
          "title": "Request Id"
        },
        "timestamp": {
          "type": "string",
          "title": "Timestamp"
        }
      },
      "type": "object",
      "required": [
        "request_id"
      ],
      "title": "Metadata"
    },
    "Source": {
      "properties": {
        "id": {
          "type": "string",
          "title": "Id",
          "description": "Content catalog identifier of the source."
        },
        "name": {
          "type": "string",
          "title": "Name",
          "description": "Catalog name of the dataset the data came from."
        }
      },
      "type": "object",
      "required": [
        "id",
        "name"
      ],
      "title": "Source",
      "description": "A content catalog source that contributed data to a structured-data response."
    },
    "Usage": {
      "additionalProperties": {
        "type": "integer"
      },
      "type": "object",
      "title": "Usage",
      "description": "Public structured-data usage for a request, aggregated per content tier.\n\nA flat object keyed per content tier, where each key is derived from the\ncontent tier identifier by dropping the ``content-`` prefix and appending\n``_tokens`` (e.g. ``corporate-fundamentals`` ->\n``corporate_fundamentals_tokens``). It is sparse: only tiers with non-zero\ntokens appear, and an absent key means zero tokens for that tier."
    }
  }
}