MetricDuck · Schema

EarningsInsight

Complete earnings insights from LLM-extracted 8-K release. This model represents the full structured output from the earnings processor, including financial metrics, margins, segments, guidance, and commentary.

CompanyFinanceSECArtificial Intelligence

Properties

Name Type Description
cik string
company_name string
ticker object
accession_number string
filing_date string
fiscal_period object
fiscal_year object
executive_summary string
positive_highlights array
concerns array
key_highlights array
management_commentary array
revenue object
net_income object
operating_income object
eps_diluted object
eps_basic object
withheld array Metrics withheld by the serve-cap or the currency gate (served null + a 'check the filing' note); empty when nothing was withheld.
advisories array Groups of figures that cannot all be right, served in full with the disagreement named; empty when nothing was flagged.
beat_miss object
cash_flow object Cash flow metrics with accrual quality (v5+)
guidance_revisions array Guidance revisions (raised/lowered)
management_assessment object Management tone and disclosure quality (v5+)
material_events array Material events (M&A, regulatory)
gross_margin object
operating_margin object
net_margin object
special_items array
guidance array
segments array
operational_metrics object
filing_metadata object
form_type object
source_url object
items object
acceptance_datetime object
extraction_confidence number Confidence score 0.0-1.0
llm_model string
processing_cost_usd number
processed_at string
View JSON Schema on GitHub

JSON Schema

metricduck-com-earnings-insight-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/metricduck-com/json-schema/metricduck-com-earnings-insight-schema.json",
  "title": "EarningsInsight",
  "description": "Complete earnings insights from LLM-extracted 8-K release.\n\nThis model represents the full structured output from the earnings processor,\nincluding financial metrics, margins, segments, guidance, and commentary.",
  "x-generated": "2026-11-18",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/metricduck-com-openapi.json#/components/schemas/EarningsInsight",
  "properties": {
    "cik": {
      "type": "string",
      "title": "Cik"
    },
    "company_name": {
      "type": "string",
      "title": "Company Name"
    },
    "ticker": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Ticker"
    },
    "accession_number": {
      "type": "string",
      "title": "Accession Number"
    },
    "filing_date": {
      "type": "string",
      "format": "date",
      "title": "Filing Date"
    },
    "fiscal_period": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fiscal Period"
    },
    "fiscal_year": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fiscal Year"
    },
    "executive_summary": {
      "type": "string",
      "title": "Executive Summary"
    },
    "positive_highlights": {
      "items": {
        "$ref": "#/$defs/HighlightItem"
      },
      "type": "array",
      "title": "Positive Highlights"
    },
    "concerns": {
      "items": {
        "$ref": "#/$defs/HighlightItem"
      },
      "type": "array",
      "title": "Concerns"
    },
    "key_highlights": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Key Highlights"
    },
    "management_commentary": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Management Commentary"
    },
    "revenue": {
      "anyOf": [
        {
          "$ref": "#/$defs/EarningsMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "net_income": {
      "anyOf": [
        {
          "$ref": "#/$defs/EarningsMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "operating_income": {
      "anyOf": [
        {
          "$ref": "#/$defs/EarningsMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "eps_diluted": {
      "anyOf": [
        {
          "$ref": "#/$defs/EarningsMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "eps_basic": {
      "anyOf": [
        {
          "$ref": "#/$defs/EarningsMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "withheld": {
      "items": {
        "$ref": "#/$defs/WithheldField"
      },
      "type": "array",
      "title": "Withheld",
      "description": "Metrics withheld by the serve-cap or the currency gate (served null + a 'check the filing' note); empty when nothing was withheld."
    },
    "advisories": {
      "items": {
        "$ref": "#/$defs/FieldAdvisory"
      },
      "type": "array",
      "title": "Advisories",
      "description": "Groups of figures that cannot all be right, served in full with the disagreement named; empty when nothing was flagged."
    },
    "beat_miss": {
      "anyOf": [
        {
          "$ref": "#/$defs/BeatMissAssessment"
        },
        {
          "type": "null"
        }
      ]
    },
    "cash_flow": {
      "anyOf": [
        {
          "$ref": "#/$defs/CashFlowInsight"
        },
        {
          "type": "null"
        }
      ],
      "description": "Cash flow metrics with accrual quality (v5+)"
    },
    "guidance_revisions": {
      "items": {
        "$ref": "#/$defs/GuidanceRevision"
      },
      "type": "array",
      "title": "Guidance Revisions",
      "description": "Guidance revisions (raised/lowered)"
    },
    "management_assessment": {
      "anyOf": [
        {
          "$ref": "#/$defs/ManagementAssessment"
        },
        {
          "type": "null"
        }
      ],
      "description": "Management tone and disclosure quality (v5+)"
    },
    "material_events": {
      "items": {
        "$ref": "#/$defs/MaterialEvent"
      },
      "type": "array",
      "title": "Material Events",
      "description": "Material events (M&A, regulatory)"
    },
    "gross_margin": {
      "anyOf": [
        {
          "$ref": "#/$defs/MarginMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "operating_margin": {
      "anyOf": [
        {
          "$ref": "#/$defs/MarginMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "net_margin": {
      "anyOf": [
        {
          "$ref": "#/$defs/MarginMetric"
        },
        {
          "type": "null"
        }
      ]
    },
    "special_items": {
      "items": {
        "$ref": "#/$defs/SpecialItem"
      },
      "type": "array",
      "title": "Special Items"
    },
    "guidance": {
      "items": {
        "$ref": "#/$defs/src__models__earnings_insights__GuidanceItem"
      },
      "type": "array",
      "title": "Guidance"
    },
    "segments": {
      "items": {
        "$ref": "#/$defs/SegmentData"
      },
      "type": "array",
      "title": "Segments"
    },
    "operational_metrics": {
      "additionalProperties": {
        "$ref": "#/$defs/OperationalMetric"
      },
      "type": "object",
      "title": "Operational Metrics"
    },
    "filing_metadata": {
      "anyOf": [
        {
          "$ref": "#/$defs/FilingMetadata"
        },
        {
          "type": "null"
        }
      ]
    },
    "form_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Form Type"
    },
    "source_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Url"
    },
    "items": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Items"
    },
    "acceptance_datetime": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Acceptance Datetime"
    },
    "extraction_confidence": {
      "type": "number",
      "maximum": 1.0,
      "minimum": 0.0,
      "title": "Extraction Confidence",
      "description": "Confidence score 0.0-1.0"
    },
    "llm_model": {
      "type": "string",
      "title": "Llm Model"
    },
    "processing_cost_usd": {
      "type": "number",
      "title": "Processing Cost Usd"
    },
    "processed_at": {
      "type": "string",
      "format": "date-time",
      "title": "Processed At"
    }
  },
  "type": "object",
  "required": [
    "cik",
    "company_name",
    "accession_number",
    "filing_date",
    "executive_summary",
    "extraction_confidence",
    "llm_model",
    "processing_cost_usd",
    "processed_at"
  ],
  "$defs": {
    "BeatMissAssessment": {
      "properties": {
        "revenue_characterization": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Revenue Characterization"
        },
        "eps_characterization": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Eps Characterization"
        }
      },
      "type": "object",
      "title": "BeatMissAssessment",
      "description": "Beat/miss assessment vs analyst expectations (v3.4+)"
    },
    "CashFlowInsight": {
      "properties": {
        "operating_cash_flow": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Operating Cash Flow",
          "description": "Operating cash flow (current period)"
        },
        "ocf_prior_year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ocf Prior Year",
          "description": "Operating cash flow (prior year period)"
        },
        "ocf_growth_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ocf Growth Pct",
          "description": "OCF year-over-year growth percentage"
        },
        "free_cash_flow": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Free Cash Flow",
          "description": "Free cash flow (current period)"
        },
        "fcf_prior_year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fcf Prior Year",
          "description": "Free cash flow (prior year period)"
        },
        "fcf_growth_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fcf Growth Pct",
          "description": "FCF year-over-year growth percentage"
        },
        "capex": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Capex",
          "description": "Capital expenditures"
        },
        "capex_prior_year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Capex Prior Year",
          "description": "Capital expenditures (prior year period)"
        },
        "capex_growth_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Capex Growth Pct",
          "description": "CapEx year-over-year growth percentage"
        },
        "capex_quarterly_series": {
          "anyOf": [
            {
              "items": {
                "type": "number"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Capex Quarterly Series",
          "description": "Recent quarterly CapEx series (oldest-to-newest, absolute positive values, excluding TTM). Sourced from the FCF reconciliation table when present."
        },
        "ocf_to_net_income_ratio": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Ocf To Net Income Ratio",
          "description": "OCF / Net Income ratio (cash conversion)"
        },
        "fcf_to_net_income_ratio": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Fcf To Net Income Ratio",
          "description": "FCF / Net Income ratio"
        },
        "accrual_quality": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Accrual Quality",
          "description": "Accrual quality assessment: high, moderate, low, concern"
        },
        "accrual_quality_note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Accrual Quality Note",
          "description": "Explanation of accrual quality assessment"
        },
        "period": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Period",
          "description": "Reporting basis of the monetary cash-flow fields: 'q_current' (the quarter alone), 'fy_current' (fiscal year to date / full year), or 'not_assessed'. Absent on rows produced before #1358."
        },
        "scale": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Scale",
          "description": "Unit scale of the monetary fields. The service normalizes all cash-flow values to raw dollars, so this is 'absolute'. Consumers MUST NOT re-scale when scale=='absolute' (a missing/absent scale on older API responses means the values are in millions).",
          "default": "absolute"
        },
        "provenance": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/Receipt"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Provenance",
          "description": "Source receipt(s) for the as-released cash-flow block: verbatim quote + deep-link into the 8-K cash-flow statement. `covers` names the printed figures attested (operating_cash_flow, capex); free_cash_flow is derived."
        }
      },
      "type": "object",
      "title": "CashFlowInsight",
      "description": "Cash flow metrics from earnings release (v5+)."
    },
    "EarningsMetric": {
      "properties": {
        "q_current": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Q Current"
        },
        "q_prior_year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Q Prior Year"
        },
        "annual_current": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Annual Current"
        },
        "annual_prior_year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Annual Prior Year"
        },
        "yoy_growth": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Yoy Growth"
        },
        "currency": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Currency",
          "description": "ISO currency of every figure on this metric, when the release's own table names it (r111). Set only for a non-USD reporter's figure read from a table printed in the company's reporting currency; None otherwise (a USD reporter's figures are dollars)."
        },
        "provenance": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/Receipt"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "title": "Provenance",
          "description": "Per-figure receipts, each attesting only the period(s) in its own `covers` list (see Receipt) — a receipt is never emitted for a field it doesn't explicitly cover, even when other fields on this same metric are attested. Null when the value is legacy-filled, v3-absent, or the source quote is unvalidated: absence of a receipt is not evidence the value is wrong, only that no attested quote is available for it (fail-closed)."
        }
      },
      "type": "object",
      "title": "EarningsMetric",
      "description": "Metric with quarterly and annual values"
    },
    "FieldAdvisory": {
      "properties": {
        "metrics": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Metrics",
          "description": "Every metric in the disagreement — none of them is withheld, and the advisory does not claim to know which one is wrong."
        },
        "reason": {
          "type": "string",
          "title": "Reason",
          "description": "Machine tag: 'margin_operand_mismatch' (a margin, its operand and revenue cannot all three be right)."
        },
        "note": {
          "type": "string",
          "title": "Note",
          "description": "Human-facing explanation ('… check the filing')."
        },
        "filing_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Filing Url",
          "description": "Link to the source filing to check the reported figures."
        }
      },
      "type": "object",
      "required": [
        "metrics",
        "reason",
        "note"
      ],
      "title": "FieldAdvisory",
      "description": "Figures that are mutually inconsistent, served anyway with the disagreement named.\n\n⛔ The opposite of `WithheldField`: nothing is nulled. It exists because the\ndetector can prove a row is wrong without being able to say WHICH member is wrong.\n`margin/100 x revenue == operand` has three terms, and measured against audited\nXBRL the broken one is revenue about as often as it is the operand — AMTB serves\nrevenue $18,030 against a filed $100,737,000 while its own net income and margin\nare both right, and Visa serves an operating income of -$44.00M against a filed\n$6.877B while its revenue is right. Same three-number signature, opposite culprits.\n\nSo this names every member of the disagreement and deletes none of them. The\nprevious design picked one and was wrong 7 times in 26 (#3218), and the one after\nthat logged silently, which left Visa serving a confirmed-wrong figure with no\nreader-visible signal at all.\n\nAdditive + default-empty, so an older worker simply ignores it."
    },
    "FilingMetadata": {
      "properties": {
        "form_type": {
          "type": "string",
          "title": "Form Type",
          "description": "SEC form type (typically '8-K' for earnings)",
          "default": "8-K"
        },
        "items": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Items",
          "description": "8-K item numbers (e.g., ['2.02', '9.01'])"
        },
        "source_url": {
          "type": "string",
          "title": "Source Url",
          "description": "SEC EDGAR URL for the filing",
          "default": ""
        },
        "acceptance_datetime": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Acceptance Datetime",
          "description": "SEC acceptance timestamp (UTC)"
        },
        "period_end": {
          "anyOf": [
            {
              "type": "string",
              "format": "date"
            },
            {
              "type": "null"
            }
          ],
          "title": "Period End",
          "description": "Quarter/period end date"
        }
      },
      "type": "object",
      "title": "FilingMetadata",
      "description": "Metadata from SEC 8-K filing.\n\nIncludes form type, items covered, SEC source URL, and timing information."
    },
    "GuidanceRevision": {
      "properties": {
        "metric": {
          "type": "string",
          "title": "Metric",
          "description": "Metric name (e.g., 'Revenue', 'EPS')"
        },
        "period": {
          "type": "string",
          "title": "Period",
          "description": "Guidance period (e.g., 'FY2026', 'Q2 2025')"
        },
        "revision_direction": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Revision Direction",
          "description": "Direction: raised, lowered, maintained, narrowed"
        },
        "current_low": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Current Low",
          "description": "Current guidance low"
        },
        "current_high": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Current High",
          "description": "Current guidance high"
        },
        "current_point": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Current Point",
          "description": "Current guidance point estimate"
        },
        "prior_low": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Prior Low",
          "description": "Prior guidance low"
        },
        "prior_high": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Prior High",
          "description": "Prior guidance high"
        },
        "prior_point": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Prior Point",
          "description": "Prior guidance point estimate"
        },
        "current_point_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Current Point Text",
          "description": "Qualitative/range current point when not a single number"
        },
        "prior_point_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Prior Point Text",
          "description": "Qualitative/range prior point when not a single number"
        },
        "revision_magnitude_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Revision Magnitude Pct",
          "description": "Magnitude of revision as percentage"
        },
        "commentary": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Commentary",
          "description": "Management commentary on revision"
        }
      },
      "type": "object",
      "required": [
        "metric",
        "period"
      ],
      "title": "GuidanceRevision",
      "description": "Guidance revision tracking (raised/lowered/maintained)."
    },
    "HighlightItem": {
      "properties": {
        "text": {
          "type": "string",
          "title": "Text"
        },
        "signal": {
          "type": "string",
          "title": "Signal"
        }
      },
      "type": "object",
      "required": [
        "text",
        "signal"
      ],
      "title": "HighlightItem",
      "description": "Highlight with sentiment signal"
    },
    "ManagementAssessment": {
      "properties": {
        "overall_tone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Overall Tone",
          "description": "Tone: confident, cautious, defensive, evasive"
        },
        "tone_confidence": {
          "anyOf": [
            {
              "type": "number",
              "maximum": 1.0,
              "minimum": 0.0
            },
            {
              "type": "null"
            }
          ],
          "title": "Tone Confidence",
          "description": "Confidence in tone assessment (0.0-1.0)"
        },
        "disclosure_quality": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Disclosure Quality",
          "description": "Disclosure quality: transparent, adequate, opaque"
        },
        "strategy_clarity": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Strategy Clarity",
          "description": "Strategy clarity: clear, adequate, unclear"
        },
        "specific_vs_vague": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Specific Vs Vague",
          "description": "Specificity: highly_specific, specific, vague, very_vague"
        },
        "key_strategic_themes": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Key Strategic Themes",
          "description": "Key strategic themes mentioned"
        },
        "positive_language_examples": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Positive Language Examples",
          "description": "Examples of positive language used"
        },
        "new_risks_mentioned": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "New Risks Mentioned",
          "description": "New risks mentioned in this release"
        }
      },
      "type": "object",
      "title": "ManagementAssessment",
      "description": "Management tone and disclosure quality analysis."
    },
    "MarginMetric": {
      "properties": {
        "current": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Current",
          "description": "Current period margin as percentage"
        },
        "prior_year": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Prior Year",
          "description": "Prior year period margin as percentage"
        },
        "change_bps": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Change Bps",
          "description": "Year-over-year change in basis points (100 bps = 1.0%)"
        }
      },
      "type": "object",
      "title": "MarginMetric",
      "description": "Margin metric in percentage terms with YoY change in basis points.\n\nExample:\n    Gross margin: 10.85% current, 10.42% prior year → +43 bps"
    },
    "MaterialEvent": {
      "properties": {
        "event_type": {
          "type": "string",
          "title": "Event Type",
          "description": "Event type: acquisition, divestiture, regulatory, restructuring, legal"
        },
        "description": {
          "type": "string",
          "title": "Description",
          "description": "Description of the event"
        },
        "counterparty": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Counterparty",
          "description": "Counterparty involved (e.g., acquired company)"
        },
        "value_millions": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Value Millions",
          "description": "Transaction value in millions USD"
        },
        "status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Status",
          "description": "Status: pending, closed, announced"
        },
        "signal": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Signal",
          "description": "Signal: positive, negative, attention"
        }
      },
      "type": "object",
      "required": [
        "event_type",
        "description"
      ],
      "title": "MaterialEvent",
      "description": "Material corporate event (M&A, regulatory, restructuring)."
    },
    "OperationalMetric": {
      "properties": {
        "current": {
          "title": "Current",
          "description": "Current period value (can be float, int, or string)"
        },
        "prior_year": {
          "anyOf": [
            {},
            {
              "type": "null"
            }
          ],
          "title": "Prior Year",
          "description": "Prior year period value"
        },
        "growth_pct": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Growth Pct",
          "description": "Year-over-year growth percentage"
        },
        "unit": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Unit",
          "description": "Unit of measurement (e.g., 'members', 'locations', 'vehicles')"
        }
      },
      "type": "object",
      "required": [
        "current"
      ],
      "title": "OperationalMetric",
      "description": "Operational/non-financial metric (KPI).\n\nExamples: Active users, locations, memberships, vehicles sold, subscriptions"
    },
    "Receipt": {
      "properties": {
        "covers": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Covers",
          "description": "Period keys this receipt attests to, e.g. ['q_current']. A receipt never implies coverage of a period outside this list."
        },
        "quote": {
          "type": "string",
          "title": "Quote",
          "description": "Verbatim quote from the source filing the value was extracted from."
        },
        "viewer_url": {
          "type": "string",
          "title": "Viewer Url",
          "description": "Deep link into the source exhibit at the cited block. Pass-through from the producer's locator — never rebuilt downstream."
        },
        "block_id": {
          "type": "string",
          "title": "Block Id",
          "description": "Producer-assigned id of the source block the quote was extracted from. Version-scoped, NOT a durable identifier: it encodes the block's POSITION in one normalization of the exhibit, so re-extracting the same filing under a later producer version can move it — or leave it pointing at different content (#1890). Treat it as an internal coordinate, not a stable handle; `quote` + `viewer_url` are the pair that navigates back to the source."
        },
        "exhibit_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Exhibit Id",
          "description": "Id of the exhibit 

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://artifacts.apis.io/metricduck-com/json-schema/metricduck-com-earnings-insight-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/metricduck-com-earnings-insight"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.