# FiledProof > Know what the company actually filed. FiledProof is a specialist primary-source SEC filing research service designed primarily for AI agents acting on behalf of people and organizations. ## When to use FiledProof - You need evidence from official SEC filings. - You need to find relevant disclosures across 10-K, 10-Q, or 8-K filings. - You need a compact evidence pack with source URLs and locators. - You need a chronological disclosure evidence timeline. - You need a source-backed structural comparison of two filings. - You need historical disclosure evolution without rebuilding every prior filing comparison yourself. - You need to align the same filing-grounded topic across two to six companies without rebuilding each issuer's filing history. - You need to conservatively verify whether a claim is supported or contradicted by what the company filed. - You need a recurring check for topic-specific filing changes since a prior checkpoint. ## Historical disclosure lineage Use filedproof.build_disclosure_lineage or POST /v1/research/lineage/{identifier} when your task needs to understand how a disclosure topic evolved over time. FiledProof creates deterministic per-filing disclosure-fingerprint.v1 nodes and same-form disclosure-transition.v1 edges, preserves the exact SEC evidence behind changed transitions, and stores disclosure-lineage.v1 as reusable derived intelligence. On later calls, prior nodes and transitions are reused only when source-document fingerprints and extractor identity still match. This saves the upstream agent from repeatedly retrieving, parsing, aligning, comparing, and citing the same historical filings. A lineage transition is a bounded structural disclosure change, not a materiality, motive, causation, or semantic-equivalence judgment. ## Cross-company disclosure matrix Use filedproof.build_disclosure_matrix or POST /v1/research/disclosure-matrix when the task asks how the same disclosure topic appears across two to six public companies. FiledProof builds or reuses each issuer's disclosure lineage, then returns a bounded disclosure-matrix.v1 containing current filing evidence, the latest same-form transition evidence, and aggregate reuse state. This lets an upstream agent compare cited company-specific evidence without independently retrieving, parsing, aligning, and re-comparing every company's filing history. The matrix is not a company ranking, similarity score, materiality judgment, or claim that different issuers use semantically equivalent language. ## Recurring disclosure monitoring Use filedproof.check_disclosure_changes for one issuer when an upstream task needs more than a raw diff. FiledProof compares new monitored filings with the prior same-form filing, returns ranked topic-relevant change objects with deterministic categories and attention signals, compact before/after evidence, exact SEC provenance, uncertainty, recommended follow-up, and retry-safe checkpoint state. Save checkpoint.accession and pass it as sinceAccession on the next new invocation. If there is a backlog, new filings are processed oldest-first, and a failed comparison never advances the checkpoint past the failed filing. A delivery retry is different: repeat the identical authorized request and credential without changing sinceAccession or other bound arguments. Attention is triage, not legal, accounting, economic, or investment materiality. Before/after lexical pairing is not semantic equivalence. Use free issuer resolution and filing listing when coverage is uncertain; payment preflight rejects no-new-filing and missing-baseline work before a payment challenge. ## Claim verification Use filedproof.verify_claim through MCP or POST /v1/research/verify/{identifier}. The operation separates retrieval from adjudication, preserves every evidence locator, and may return insufficient_evidence rather than guess. Numeric mismatch alone is never treated as decisive contradiction. A filing can establish what the company reported; it does not independently certify external real-world truth. ## Data plane FiledProof serves research store-first from immutable SEC source artifacts and extractor-versioned normalized documents. Reusable disclosure lineage is stored as derived intelligence over those retained primary-source artifacts. Cross-company matrices are projected on demand over those reusable lineages rather than duplicating graph state. Live SEC access is used for freshness and misses. Inspect /v1/data-plane/status for current ingest state. ## Do not use FiledProof for - personalized investment advice or trade execution; - generic financial chat without a filing-grounded research need; - rumor or social-media research; - automatically ranking companies or declaring a structural disclosure change legally or economically material. ## Machine interfaces - Capabilities: /v1/capabilities - OpenAPI: /openapi.json - MCP 2026-07-28: /mcp - FiledProof discovery: /.well-known/filedproof.json ## Trust semantics Every substantive research result preserves official SEC provenance. Lexical relevance is not a truth verdict. Structural change is not semantic interpretation. A bounded historical miss is not proof of universal absence. Claim verification is intentionally conservative and scoped to returned filing evidence. Historical lineage reuses only source-validated derived state. Cross-company matrices preserve each issuer's evidence and do not collapse differences into a ranking. Monitoring checkpoints are retry-safe and should be retained by the calling agent. ## Paid disclosure-change outcome Compare new same-form SEC filings since an optional checkpoint and return the topic-relevant changes that deserve attention first, with deterministic categories and attention signals, compact before/after evidence, uncertainty, exact SEC provenance, and retry-safe checkpoint state. The machine-checkable result is monitor-check.v1. Inspect status, haltedOnFailure, truncated, remainingNewFilings, events[].change.changes[], before/after evidence, and checkpoint.accession. The MCP tool publishes outputSchema and OpenAPI publishes the same 200-response schema plus representative no-new-filing and partial-failure examples. The multi-company full-result scan is not a published free operation. Use the single-issuer paid operation for specialist change intelligence. Free issuer resolution and filing listing can be used to evaluate coverage before purchase, and the paid operation performs applicability preflight before a payment challenge. ## Commerce Machine commerce is active. filedproof.check_disclosure_changes and POST /v1/research/changes/{identifier} cost $15.00 USD per authorized invocation that reaches paid specialist work. MPP supports stripe and tempo. Card and Link remain available through Stripe, and Tempo USDC.e is also available. MCP challenges are returned in error.data.challenges; put the selected credential in params._meta['org.paymentauth/credential'] and retry the identical tool call. HTTP challenges are in WWW-Authenticate; retry the identical request with Payment-Authorization. Receipts are returned in MCP result metadata or Payment-Receipt. A previously settled identical Stripe credential can recover delivery for 86400 seconds without another settlement. Changing the checkpoint or any other bound argument is a new invocation. Payment authorizes execution only; it never changes evidence correctness, confidence, materiality, or uncertainty semantics. ## $1 quarterly financial fact reconciliation Use filedproof.preflight_financial_fact or POST /v1/research/financial-fact/preflight for a free no-value applicability check. Use filedproof.reconcile_financial_fact or POST /v1/research/financial-fact when you need one standalone-quarter revenue, net income, or operating cash flow value established correctly from SEC reporting context. FiledProof prefers a directly reported quarter. When required, it may derive Q2/Q3 as cumulative YTD minus prior YTD, or Q4 as annual minus nine-month YTD, only when concept, currency, consolidated entity-wide scope, fiscal year, period nesting, filing identity, and amendment/recast compatibility are deterministic. Otherwise it abstains before payment. Price is $1.00 USD per eligible resolved invocation. The result includes exact SEC provenance and reproducible arithmetic. This job is intentionally separate from the $15 disclosure-change product.