FiledProof

Resolve a ticker, CIK, or exact company name to one SEC issuer. Use this first when issuer identity is uncertain or before passing a CIK or accession into another FiledProof tool. Do not use it to list filings or search disclosure text; use filedproof.list_filings or filedproof.search_evidence after identity is resolved.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    }
  },
  "required": [
    "identifier"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

List recent or bounded historical SEC filings with canonical source metadata and explicit coverage limits. Use this when you need form, filing-date, or accession inventory, when choosing an exact pair for filedproof.compare_filings, or when confirming coverage before filedproof.check_disclosure_changes. For passage-level research, use filedproof.search_evidence instead.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 12,
      "description": "SEC filing form types to include, such as 10-K, 10-Q, or 8-K."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20,
      "description": "Maximum number of operation-specific evidence or result records to return."
    },
    "history": {
      "type": "boolean",
      "default": false,
      "description": "Whether to use bounded historical SEC submission archives when needed."
    }
  },
  "required": [
    "identifier"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Find relevant primary-source passages across a bounded set of SEC filings. Use this for open-ended filing research when you want evidence records with provenance but do not need a claim verdict or a curated answer bundle. Use filedproof.verify_claim for one explicit factual proposition, filedproof.build_evidence_pack for a compact answer-ready bundle, or filedproof.build_timeline when chronology is the main objective. Relevance is not a truth verdict.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Research question or disclosure topic."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "SEC forms to search. Defaults to 10-K and 10-Q."
    },
    "filings": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6,
      "default": 3,
      "description": "Maximum number of filings to inspect for this invocation."
    },
    "history": {
      "type": "boolean",
      "default": false,
      "description": "Whether to use bounded historical SEC submission archives when needed."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item, such as 1A or 7."
    },
    "section": {
      "type": "string",
      "description": "Optional exact normalized section heading."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Maximum number of operation-specific evidence or result records to return."
    }
  },
  "required": [
    "identifier",
    "q"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Package the strongest relevant SEC evidence for an upstream AI agent, preserving source URLs, locators, search scope, coverage, and explicit non-inference rules. Use this when the research question is already known and the caller wants a compact evidence bundle ready for downstream reasoning. Use filedproof.search_evidence for broader retrieval, filedproof.verify_claim for an explicit support-or-contradiction verdict, or filedproof.build_timeline for chronological organization.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Research question or disclosure topic."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "SEC forms to search. Defaults to 10-K and 10-Q."
    },
    "filings": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6,
      "default": 3,
      "description": "Maximum number of filings to inspect for this invocation."
    },
    "history": {
      "type": "boolean",
      "default": false,
      "description": "Whether to use bounded historical SEC submission archives when needed."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item, such as 1A or 7."
    },
    "section": {
      "type": "string",
      "description": "Optional exact normalized section heading."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 12,
      "description": "Maximum number of operation-specific evidence or result records to return."
    }
  },
  "required": [
    "identifier",
    "q"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Organize topic-relevant filing evidence chronologically across a bounded set of SEC filings. Use this when sequence over time is the primary need. Use filedproof.build_disclosure_lineage when you need persisted same-form evolution and reusable transition state, filedproof.compare_filings for exactly two known accessions, or filedproof.check_disclosure_changes for prioritized monitoring of newly filed changes. The timeline does not invent semantic change or materiality.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Research question or disclosure topic."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "SEC forms to search. Defaults to 10-K and 10-Q."
    },
    "filings": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6,
      "default": 3,
      "description": "Maximum number of filings to inspect for this invocation."
    },
    "history": {
      "type": "boolean",
      "default": false,
      "description": "Whether to use bounded historical SEC submission archives when needed."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item, such as 1A or 7."
    },
    "section": {
      "type": "string",
      "description": "Optional exact normalized section heading."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 30,
      "description": "Maximum number of operation-specific evidence or result records to return."
    }
  },
  "required": [
    "identifier",
    "q"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Conservatively assess one explicit factual claim against official SEC filing evidence and return support, contradiction, mixed, partial, or insufficient-evidence stance signals. Use this when the caller already has a proposition to test. Use filedproof.search_evidence for open-ended research, filedproof.reconcile_financial_fact for one supported standalone-quarter revenue, net-income, or operating-cash-flow value, or filedproof.check_disclosure_changes for new disclosure-change monitoring. A filing establishes what the company reported, not independent real-world truth.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "claim": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "The factual claim to assess against the company's SEC filings."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "SEC forms to search. Defaults to 10-K, 10-Q, and 8-K."
    },
    "filings": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6,
      "default": 6,
      "description": "Maximum number of filings to inspect for this invocation."
    },
    "history": {
      "type": "boolean",
      "default": false,
      "description": "Whether to use bounded historical SEC submission archives when needed."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item such as 1A or 7."
    },
    "section": {
      "type": "string",
      "description": "Optional exact normalized section heading."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "default": 24,
      "description": "Maximum number of operation-specific evidence or result records to return."
    }
  },
  "required": [
    "identifier",
    "claim"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Build or reuse a persisted disclosure history for one issuer and topic, with deterministic per-filing fingerprints and same-form transition edges backed by exact SEC evidence. Use this when historical evolution or repeat reuse matters. Use filedproof.compare_filings for a one-off exact filing pair, filedproof.build_timeline for simple chronology without reusable transition state, or filedproof.build_disclosure_matrix when the objective is comparison across multiple companies. Structural change is not a materiality judgment.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "topic": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Public-company disclosure topic whose filing-to-filing history should be accumulated, such as AI regulation, cybersecurity, or supply-chain concentration."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "SEC forms to include. Defaults to 10-K and 10-Q. Same-form transitions are linked independently."
    },
    "filings": {
      "type": "integer",
      "minimum": 2,
      "maximum": 6,
      "default": 6,
      "description": "Maximum filings to inspect in this invocation. Previously persisted lineage can contain more accumulated history."
    },
    "history": {
      "type": "boolean",
      "default": true,
      "description": "Use bounded historical SEC submission archives when the durable catalog does not already provide enough history."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item such as 1A or 7."
    },
    "section": {
      "type": "string",
      "description": "Optional exact normalized section heading."
    },
    "fingerprintLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 50,
      "description": "Maximum relevant evidence records used to fingerprint one filing."
    },
    "comparisonLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 250,
      "description": "Maximum changed blocks inspected in each same-form structural comparison."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30,
      "description": "Maximum topic-relevant change evidence records retained per transition."
    }
  },
  "required": [
    "identifier",
    "topic"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Align one disclosure topic across two to six public companies using each company's source-backed historical disclosure lineage. Use this when cross-company comparison is the objective and the caller needs current evidence plus latest same-form transition evidence on a common basis without independently retrieving, parsing, aligning, and re-comparing every filing history. Use filedproof.build_disclosure_lineage for one issuer, not this tool; use filedproof.check_disclosure_changes when monitoring newly filed changes for one issuer. The matrix is an evidence substrate, not a ranking or materiality judgment.

{
  "type": "object",
  "properties": {
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "minItems": 2,
      "maxItems": 6,
      "description": "Two to six public-company identifiers to align on the same filing-grounded disclosure topic."
    },
    "topic": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Disclosure topic to align across companies, such as cybersecurity, AI infrastructure, or supply-chain concentration."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 4,
      "default": [
        "10-K"
      ],
      "description": "SEC forms to align. Defaults to 10-K for stronger cross-company comparability."
    },
    "filings": {
      "type": "integer",
      "minimum": 2,
      "maximum": 6,
      "default": 4,
      "description": "Maximum filings per company used to build or reuse the underlying disclosure lineage."
    },
    "history": {
      "type": "boolean",
      "default": true,
      "description": "Whether to use bounded historical SEC submission archives when needed."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item such as 1A or 7."
    },
    "section": {
      "type": "string",
      "description": "Optional exact normalized section heading."
    },
    "fingerprintLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 30,
      "description": "Maximum number of relevant evidence records used to fingerprint one filing."
    },
    "comparisonLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 200,
      "description": "Maximum number of changed blocks to inspect in each filing comparison."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 24,
      "description": "Maximum topic-relevant change evidence retained in each underlying lineage transition."
    },
    "currentEvidenceLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "default": 6,
      "description": "Maximum current-filing evidence records returned per company and form."
    },
    "transitionEvidenceLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "default": 6,
      "description": "Maximum evidence records returned for each latest same-form transition."
    },
    "maxArchiveFiles": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum number of historical SEC submission archive files to inspect when history is enabled."
    }
  },
  "required": [
    "identifiers",
    "topic"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Configured 0.10 USD fast specialist operation when runtime commerce is active. Compare two same-form 10-K or 10-Q filings and return source-grounded meaningful changes, explainable decision-relevance triage, low-signal/no-change sections, confidence, limitations, and routing guidance when deeper disclosure verification is warranted. Supply both accessions for an exact pair, or omit both and choose form so FiledProof deterministically selects the latest comparable pair. This is not a legal materiality or investment-significance determination.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "earlierAccession": {
      "type": "string",
      "minLength": 1,
      "description": "Optional earlier SEC accession. Supply together with laterAccession for an exact pair."
    },
    "laterAccession": {
      "type": "string",
      "minLength": 1,
      "description": "Optional later SEC accession. Supply together with earlierAccession for an exact pair."
    },
    "form": {
      "type": "string",
      "enum": [
        "10-K",
        "10-Q"
      ],
      "default": "10-K",
      "description": "Comparable SEC form. Defaults to 10-K and must match both explicit filings when accessions are supplied."
    },
    "focus": {
      "type": "string",
      "enum": [
        "all",
        "risk",
        "liquidity_debt",
        "capital_allocation",
        "legal_regulatory",
        "strategy",
        "financial_reporting",
        "cybersecurity"
      ],
      "default": "all",
      "description": "Optional bounded decision-relevance focus. Defaults to all maintained change categories."
    },
    "history": {
      "type": "boolean",
      "default": false,
      "description": "Allow bounded historical SEC submission lookup when automatic pair resolution needs it."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item such as 1A or 7."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Maximum meaningful change objects to return."
    }
  },
  "required": [
    "identifier"
  ],
  "dependentRequired": {
    "earlierAccession": [
      "laterAccession"
    ],
    "laterAccession": [
      "earlierAccession"
    ]
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "const": "material-filing-change-check.v1"
    },
    "operation": {
      "const": "check_material_filing_changes"
    },
    "issuer": {
      "type": "object"
    },
    "earlierFiling": {
      "type": "object"
    },
    "laterFiling": {
      "type": "object"
    },
    "summary": {
      "type": "object"
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "unchangedOrLowSignalSections": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "lowSignalChanges": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "evidence": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "confidence": {
      "type": "object"
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "recommendedNextStep": {
      "anyOf": [
        {
          "type": "object"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "schemaVersion",
    "operation",
    "issuer",
    "earlierFiling",
    "laterFiling",
    "summary",
    "changes",
    "sources",
    "confidence",
    "limitations"
  ],
  "additionalProperties": true
}

Configured 1.00 USD specialist operation when runtime commerce is active. Use this for one issuer when the caller needs changes in newly filed disclosures prioritized against the prior filing of the same form, with compact before/after evidence from SEC filings and retry-safe checkpoint state. Supply a freeform topic, or profile=financial_risk for the bounded liquidity, debt, dilution/equity-issuance, and changed-risk report. The report separates documented filing changes from deterministic category/attention interpretation. Use filedproof.check_material_filing_changes for a fast low-cost same-form 10-K or 10-Q comparison, filedproof.compare_filings for a free raw structural diff between known accessions, or filedproof.list_filings first when coverage is uncertain. Attention is not a legal, accounting, economic, or investment materiality judgment, and pre-payment validation rejects invalid or non-comparable work before a charge.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "sinceAccession": {
      "type": "string",
      "description": "Checkpoint accession returned by the previous paid check. Omit for the first snapshot."
    },
    "topic": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "Disclosure topic to monitor, such as AI capital spending, China risk, or cybersecurity. Provide topic or profile, not both."
    },
    "profile": {
      "type": "string",
      "enum": [
        "financial_risk"
      ],
      "description": "Bounded report profile. financial_risk checks liquidity/capital resources, debt/borrowings/covenants/maturities, dilution/equity-issuance disclosures, and changed risk disclosures together. Provide profile or topic, not both."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "SEC forms to monitor. Defaults to 10-K and 10-Q."
    },
    "history": {
      "type": "boolean",
      "default": false,
      "description": "Whether to use bounded historical SEC submission archives when needed."
    },
    "item": {
      "type": "string",
      "description": "Optional SEC filing item such as 1A or 7."
    },
    "maxNewFilings": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6,
      "default": 3,
      "description": "Maximum newly detected filings to process in one check."
    },
    "comparisonLimit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 250,
      "description": "Maximum number of changed blocks to inspect in each filing comparison."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 30,
      "description": "Maximum topic-relevant change evidence records per filing comparison."
    },
    "maxArchiveFiles": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum historical SEC submission archive files to inspect when history is enabled."
    }
  },
  "required": [
    "identifier"
  ],
  "oneOf": [
    {
      "required": [
        "topic"
      ]
    },
    {
      "required": [
        "profile"
      ]
    }
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "const": "monitor-check.v1"
    },
    "purpose": {
      "type": "string"
    },
    "issuer": {
      "type": "object",
      "additionalProperties": true
    },
    "topic": {
      "type": "string",
      "minLength": 1
    },
    "reportProfile": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "financial_risk",
        null
      ]
    },
    "forms": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "string"
      }
    },
    "mode": {
      "type": "string",
      "enum": [
        "initial_snapshot",
        "incremental"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "no_new_filing",
        "checked",
        "change_detected",
        "partial_failure"
      ]
    },
    "changeDetected": {
      "type": "boolean"
    },
    "checkpoint": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "accession",
            "form",
            "filingDate",
            "reportDate"
          ],
          "properties": {
            "accession": {
              "type": "string",
              "minLength": 1
            },
            "form": {
              "type": [
                "string",
                "null"
              ]
            },
            "filingDate": {
              "type": [
                "string",
                "null"
              ]
            },
            "reportDate": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      ]
    },
    "priorCheckpoint": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "accession",
            "form",
            "filingDate",
            "reportDate"
          ],
          "properties": {
            "accession": {
              "type": "string",
              "minLength": 1
            },
            "form": {
              "type": [
                "string",
                "null"
              ]
            },
            "filingDate": {
              "type": [
                "string",
                "null"
              ]
            },
            "reportDate": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      ]
    },
    "latestAvailable": {
      "oneOf": [
        {
          "type": "null"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "accession",
            "form",
            "filingDate",
            "reportDate"
          ],
          "properties": {
            "accession": {
              "type": "string",
              "minLength": 1
            },
            "form": {
              "type": [
                "string",
                "null"
              ]
            },
            "filingDate": {
              "type": [
                "string",
                "null"
              ]
            },
            "reportDate": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      ]
    },
    "newFilingsDetected": {
      "type": "integer",
      "minimum": 0
    },
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "schemaVersion",
          "status",
          "current",
          "baseline",
          "change"
        ],
        "properties": {
          "schemaVersion": {
            "const": "monitor-event.v1"
          },
          "status": {
            "type": "string",
            "enum": [
              "topic_change_detected",
              "no_detected_topic_change",
              "insufficient_baseline",
              "comparison_failed"
            ]
          },
          "current": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "accession",
                  "form",
                  "filingDate",
                  "reportDate"
                ],
                "properties": {
                  "accession": {
                    "type": "string",
                    "minLength": 1
                  },
                  "form": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "filingDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "reportDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            ]
          },
          "baseline": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "accession",
                  "form",
                  "filingDate",
                  "reportDate"
                ],
                "properties": {
                  "accession": {
                    "type": "string",
                    "minLength": 1
                  },
                  "form": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "filingDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "reportDate": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                }
              }
            ]
          },
          "change": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "type": "object",
                "additionalProperties": true,
                "required": [
                  "schemaVersion",
                  "changed",
                  "changes"
                ],
                "properties": {
                  "schemaVersion": {
                    "const": "disclosure-change.v1"
                  },
                  "changed": {
                    "type": "boolean"
                  },
                  "changes": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": true,
                      "required": [
                        "kind",
                        "category",
                        "attention",
                        "confidence",
                        "signals",
                        "before",
                        "after"
                      ],
                      "properties": {
                        "kind": {
                          "type": "string",
                          "enum": [
                            "addition",
                            "removal",
                            "revised_disclosure",
                            "moved_equivalent"
                          ]
                        },
                        "category": {
                          "type": "string",
                          "minLength": 1
                        },
                        "attention": {
                          "type": "object",
                          "additionalProperties": true,
                          "required": [
                            "level",
                            "score"
                          ],
                          "properties": {
                            "level": {
                              "type": "string",
                              "enum": [
                                "high",
                                "medium",
                                "low"
                              ]
                            },
                            "score": {
                              "type": "number"
                            }
                          }
                        },
                        "confidence": {
                          "type": "string",
                          "enum": [
                            "high",
                            "medium",
                            "low"
                          ]
                        },
                        "signals": {
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "object",
                                "additionalProperties": true
                              }
                            ]
                          }
                        },
                        "classification": {
                          "type": "object",
                          "additionalProperties": true
                        },
                        "reportingContext": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true
                        },
                        "numericAnchors": {
                          "type": "object",
                          "additionalProperties": true
                        },
                        "coverageCategories": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "before": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true
                        },
                        "after": {
                          "type": [
                            "object",
                            "null"
                          ],
                          "additionalProperties": true
                        }
                      }
                    }
                  },
                  "changeCount": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "highPriorityChangeCount": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "overallAttention": {
                    "type": "string",
                    "enum": [
                      "high",
                      "medium",
                      "low",
                      "none"
                    ]
                  },
                  "attentionCounts": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "high",
                      "medium",
                      "low"
                    ],
                    "properties": {
                      "high": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "medium": {
                        "type": "integer",
                        "minimum": 0
                      },
                      "low": {
                        "type": "integer",
                        "minimum": 0
                      }
                    }
                  },
                  "limitations": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "reportProfile": {
                    "type": "string"
                  },
                  "coverage": {
                    "type": "object",
                    "additionalProperties": true
                  }
                }
              }
            ]
          },
          "limitation": {
            "type": "string"
          },
          "searchScope": {
            "type": "object",
            "additionalProperties": true
          },
          "error": {
            "type": "object",
            "additionalProperties": true,
            "required": [
              "code",
              "message",
              "retryable"
            ],
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              }
            }
          }
        }
      }
    },
    "truncated": {
      "type": "boolean"
    },
    "remainingNewFilings": {
      "type": "integer",
      "minimum": 0
    },
    "haltedOnFailure": {
      "type": "boolean"
    },
    "changeCount": {
      "type": "integer",
      "minimum": 0
    },
    "highPriorityChangeCount": {
      "type": "integer",
      "minimum": 0
    },
    "overallAttention": {
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low",
        "none"
      ]
    },
    "attentionCounts": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "high",
        "medium",
        "low"
      ],
      "properties": {
        "high": {
          "type": "integer",
          "minimum": 0
        },
        "medium": {
          "type": "integer",
          "minimum": 0
        },
        "low": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "scope": {
      "type": "object",
      "additionalProperties": true
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "agentGuidance": {
      "type": "object",
      "additionalProperties": true,
      "required": [
        "nextAction",
        "invocationBoundary"
      ],
      "properties": {
        "reviewOrder": {
          "type": "string"
        },
        "nextAction": {
          "type": "string"
        },
        "invocationBoundary": {
          "type": "string"
        }
      }
    }
  },
  "required": [
    "schemaVersion",
    "purpose",
    "issuer",
    "topic",
    "forms",
    "mode",
    "status",
    "changeDetected",
    "checkpoint",
    "priorCheckpoint",
    "latestAvailable",
    "newFilingsDetected",
    "events",
    "truncated",
    "remainingNewFilings",
    "haltedOnFailure",
    "changeCount",
    "highPriorityChangeCount",
    "overallAttention",
    "attentionCounts",
    "scope",
    "agentGuidance"
  ],
  "$id": "https://filedproof.davisvillelabs.com/schemas/monitor-check.v1",
  "additionalProperties": true
}

Compare two known filings from the same issuer and return source-backed added and removed disclosure blocks. Use this low-level operation when you already know the exact left and right accessions and only need a structural diff. Use filedproof.build_disclosure_lineage for multi-filing historical evolution, filedproof.build_timeline for topical chronology, or filedproof.check_disclosure_changes when you need prioritized new-change triage and recurring checkpoint semantics. Structural change is not semantic interpretation or a materiality judgment.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "Ticker, CIK, or exact SEC company name."
    },
    "left": {
      "type": "string",
      "minLength": 1,
      "description": "Left SEC accession number."
    },
    "right": {
      "type": "string",
      "minLength": 1,
      "description": "Right SEC accession number."
    },
    "item": {
      "type": "string",
      "description": "Optional filing item such as 1A or 7."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100,
      "description": "Maximum number of operation-specific evidence or result records to return."
    }
  },
  "required": [
    "identifier",
    "left",
    "right"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Structured FiledProof result with operation-specific evidence, provenance, coverage, and uncertainty fields.",
  "additionalProperties": true
}

Free eligibility check for filedproof.reconcile_financial_fact. Use this before the $1 specialist operation when issuer identity, filing selection, supported metric, fiscal-period dates, annual-versus-quarter context, required SEC Company Facts contexts, or an optional SEC-filed 8-K earnings-release number comparison may be uncertain. It validates applicability without revealing the filing value, comparison source value, later revision values, evidence, or arithmetic. For general filing lookup or narrative research, use filedproof.resolve_issuer, filedproof.list_filings, or filedproof.search_evidence instead.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Issuer ticker, exact company name, CIK, or CIK-prefixed identifier. FiledProof resolves this to the durable SEC CIK before research and payment."
    },
    "cik": {
      "type": "string",
      "pattern": "^(?:CIK)?\\d{1,10}$",
      "description": "Legacy/direct SEC CIK input. Prefer identifier when starting from a ticker or company name."
    },
    "anchor_accession": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "Optional 10-Q/10-K accession, including amendments. If omitted, FiledProof selects the earliest compatible filing for the requested period."
    },
    "metric": {
      "type": "string",
      "enum": [
        "revenue",
        "net_income",
        "operating_cash_flow"
      ],
      "description": "Financial metric to reconcile: revenue, net income, or operating cash flow."
    },
    "period_start": {
      "type": "string",
      "format": "date",
      "description": "Requested fiscal-period start date."
    },
    "period_end": {
      "type": "string",
      "format": "date",
      "description": "Requested fiscal-period end date."
    },
    "period_type": {
      "type": "string",
      "enum": [
        "standalone_fiscal_quarter",
        "fiscal_year"
      ],
      "default": "standalone_fiscal_quarter",
      "description": "Whether the requested value is one standalone fiscal quarter or the full fiscal year."
    },
    "as_of_date": {
      "type": "string",
      "format": "date",
      "description": "Optional historical cutoff. The selected anchor filing must have been filed on or before this date; later values never replace the primary answer."
    },
    "include_subsequent_revisions": {
      "type": "boolean",
      "default": true,
      "description": "When true, report later different values for the same SEC concept, unit, and period separately from the primary anchored value."
    },
    "comparison_accession": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "Optional SEC 8-K/8-K/A accession containing an earnings-release exhibit to compare with the filing-anchored GAAP fact. Provide comparison_value with it."
    },
    "comparison_value": {
      "type": "string",
      "pattern": "^-?\\d+$",
      "description": "Actual-unit integer value claimed from the SEC-filed earnings-release exhibit. FiledProof must find this value in metric context before the comparison is eligible."
    },
    "comparison_exhibit": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240,
      "description": "Optional exact EX-99 exhibit filename or safe relative path when an 8-K contains multiple candidate earnings-release exhibits."
    }
  },
  "required": [
    "metric",
    "period_start",
    "period_end"
  ],
  "anyOf": [
    {
      "required": [
        "identifier"
      ]
    },
    {
      "required": [
        "cik"
      ]
    }
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "const": "financial-fact-preflight.v1"
    },
    "operation": {
      "const": "filedproof.reconcile_financial_fact"
    },
    "canonicalRequest": {
      "type": "object"
    },
    "status": {
      "type": "string",
      "enum": [
        "eligible",
        "ineligible"
      ]
    },
    "eligible": {
      "type": "boolean"
    },
    "checks": {
      "type": "object",
      "required": [
        "issuerValid",
        "anchorFilingValid",
        "metricSupported",
        "requestedPeriodPlausible",
        "comparisonRequested",
        "comparisonSourceAvailable",
        "requiredContextDataAvailable"
      ],
      "properties": {
        "issuerValid": {
          "type": "boolean"
        },
        "anchorFilingValid": {
          "type": "boolean"
        },
        "metricSupported": {
          "type": "boolean"
        },
        "requestedPeriodPlausible": {
          "type": "boolean"
        },
        "comparisonRequested": {
          "type": "boolean"
        },
        "comparisonSourceAvailable": {
          "type": "boolean"
        },
        "requiredContextDataAvailable": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "price": {
      "type": "object",
      "required": [
        "cents",
        "currency"
      ],
      "properties": {
        "cents": {
          "type": "integer",
          "minimum": 0
        },
        "currency": {
          "type": "string",
          "minLength": 3,
          "maxLength": 3
        }
      },
      "additionalProperties": false
    },
    "paymentMethods": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "reason": {
      "type": "string"
    },
    "disclosureBoundary": {
      "type": "string"
    }
  },
  "required": [
    "schemaVersion",
    "operation",
    "canonicalRequest",
    "status",
    "eligible",
    "checks",
    "price",
    "paymentMethods",
    "disclosureBoundary"
  ],
  "additionalProperties": true
}

$1.00 USD specialist operation when commerce is active. Use this for one supported quarterly or fiscal-year revenue, net income, or operating cash flow fact. Optionally provide comparison_accession plus comparison_value to verify that number against an SEC-filed 8-K earnings-release exhibit and assess GAAP/non-GAAP, period, currency, and scope comparability. Arithmetic bridges are returned only when visible source rows reproduce exactly; otherwise the reason remains unresolved. Use filedproof.preflight_financial_fact first when eligibility is uncertain, filedproof.verify_claim for a narrative factual proposition, or filedproof.search_evidence for general filing research. Unsupported or ambiguous requests abstain before payment.

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Issuer ticker, exact company name, CIK, or CIK-prefixed identifier. FiledProof resolves this to the durable SEC CIK before research and payment."
    },
    "cik": {
      "type": "string",
      "pattern": "^(?:CIK)?\\d{1,10}$",
      "description": "Legacy/direct SEC CIK input. Prefer identifier when starting from a ticker or company name."
    },
    "anchor_accession": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "Optional 10-Q/10-K accession, including amendments. If omitted, FiledProof selects the earliest compatible filing for the requested period."
    },
    "metric": {
      "type": "string",
      "enum": [
        "revenue",
        "net_income",
        "operating_cash_flow"
      ],
      "description": "Financial metric to reconcile: revenue, net income, or operating cash flow."
    },
    "period_start": {
      "type": "string",
      "format": "date",
      "description": "Requested fiscal-period start date."
    },
    "period_end": {
      "type": "string",
      "format": "date",
      "description": "Requested fiscal-period end date."
    },
    "period_type": {
      "type": "string",
      "enum": [
        "standalone_fiscal_quarter",
        "fiscal_year"
      ],
      "default": "standalone_fiscal_quarter",
      "description": "Whether the requested value is one standalone fiscal quarter or the full fiscal year."
    },
    "as_of_date": {
      "type": "string",
      "format": "date",
      "description": "Optional historical cutoff. The selected anchor filing must have been filed on or before this date; later values never replace the primary answer."
    },
    "include_subsequent_revisions": {
      "type": "boolean",
      "default": true,
      "description": "When true, report later different values for the same SEC concept, unit, and period separately from the primary anchored value."
    },
    "comparison_accession": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "Optional SEC 8-K/8-K/A accession containing an earnings-release exhibit to compare with the filing-anchored GAAP fact. Provide comparison_value with it."
    },
    "comparison_value": {
      "type": "string",
      "pattern": "^-?\\d+$",
      "description": "Actual-unit integer value claimed from the SEC-filed earnings-release exhibit. FiledProof must find this value in metric context before the comparison is eligible."
    },
    "comparison_exhibit": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240,
      "description": "Optional exact EX-99 exhibit filename or safe relative path when an 8-K contains multiple candidate earnings-release exhibits."
    }
  },
  "required": [
    "metric",
    "period_start",
    "period_end"
  ],
  "anyOf": [
    {
      "required": [
        "identifier"
      ]
    },
    {
      "required": [
        "cik"
      ]
    }
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "const": "financial-fact-reconciliation.v1"
    },
    "operation": {
      "const": "filedproof.reconcile_financial_fact"
    },
    "resultId": {
      "type": "string"
    },
    "status": {
      "enum": [
        "resolved",
        "ambiguous",
        "unsupported",
        "unavailable"
      ]
    },
    "canonicalRequest": {
      "type": "object"
    },
    "issuer": {
      "type": "object"
    },
    "resolvedMetric": {
      "type": "object"
    },
    "value": {
      "type": [
        "string",
        "null"
      ]
    },
    "currency": {
      "type": [
        "string",
        "null"
      ]
    },
    "scale": {
      "type": [
        "integer",
        "null"
      ]
    },
    "units": {
      "type": [
        "string",
        "null"
      ]
    },
    "period": {
      "type": "object"
    },
    "asOf": {
      "type": "object"
    },
    "scope": {
      "type": "object"
    },
    "resultBasis": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "direct",
        "derived",
        null
      ]
    },
    "derivation": {
      "type": [
        "object",
        "null"
      ]
    },
    "evidence": {
      "type": "array"
    },
    "originalReported": {
      "type": [
        "object",
        "null"
      ]
    },
    "subsequentReportedValues": {
      "type": "array"
    },
    "revisionAssessment": {
      "type": "object"
    },
    "validation": {
      "type": "object"
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "unresolvedQuestions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "object"
    },
    "anchorFiling": {
      "type": "object"
    },
    "numberReconciliation": {
      "type": [
        "object",
        "null"
      ]
    }
  },
  "required": [
    "schemaVersion",
    "operation",
    "resultId",
    "status",
    "canonicalRequest",
    "issuer",
    "resolvedMetric",
    "period",
    "asOf",
    "scope",
    "source",
    "anchorFiling",
    "value",
    "currency",
    "resultBasis",
    "derivation",
    "evidence",
    "originalReported",
    "subsequentReportedValues",
    "revisionAssessment",
    "validation",
    "limitations",
    "unresolvedQuestions"
  ],
  "additionalProperties": true
}