---
title: "Reconcile one SEC financial fact"
method: POST
path: "/v1/research/financial-fact"
---

# Reconcile one SEC financial fact

`POST /v1/research/financial-fact`

## Request

- Base URL: `https://filedproof.davisvillelabs.com`
- URL: `https://filedproof.davisvillelabs.com/v1/research/financial-fact`
- Auth: none declared

Reconcile one quarterly or fiscal-year revenue, net income, or operating cash flow fact from official SEC reporting context; optionally verify a caller-supplied number against an SEC-filed 8-K earnings-release exhibit, assess GAAP/non-GAAP, period, currency, and scope comparability, return an exact arithmetic bridge only when visible source rows reproduce it, and explicitly leave unsupported explanations unresolved. Free applicability work occurs before any payment challenge.

## Request body

- union
  - object
    - `identifier` string, required: Issuer ticker, exact company name, CIK, or CIK-prefixed identifier. FiledProof resolves this to the durable SEC CIK before research and payment.
    - `cik` string: Legacy/direct SEC CIK input. Prefer identifier when starting from a ticker or company name.
    - `anchor_accession` string: Optional 10-Q/10-K accession, including amendments. If omitted, FiledProof selects the earliest compatible filing for the requested period.
    - `metric` 'revenue' | 'net_income' | 'operating_cash_flow', required: Financial metric to reconcile: revenue, net income, or operating cash flow.
    - `period_start` string, date, required: Requested fiscal-period start date.
    - `period_end` string, date, required: Requested fiscal-period end date.
    - `period_type` 'standalone_fiscal_quarter' | 'fiscal_year': Whether the requested value is one standalone fiscal quarter or the full fiscal year.
    - `as_of_date` string, date: 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` boolean: When true, report later different values for the same SEC concept, unit, and period separately from the primary anchored value.
    - `comparison_accession` string: 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` string: 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` string: Optional exact EX-99 exhibit filename or safe relative path when an 8-K contains multiple candidate earnings-release exhibits.
  - object
    - `identifier` string: Issuer ticker, exact company name, CIK, or CIK-prefixed identifier. FiledProof resolves this to the durable SEC CIK before research and payment.
    - `cik` string, required: Legacy/direct SEC CIK input. Prefer identifier when starting from a ticker or company name.
    - `anchor_accession` string: Optional 10-Q/10-K accession, including amendments. If omitted, FiledProof selects the earliest compatible filing for the requested period.
    - `metric` 'revenue' | 'net_income' | 'operating_cash_flow', required: Financial metric to reconcile: revenue, net income, or operating cash flow.
    - `period_start` string, date, required: Requested fiscal-period start date.
    - `period_end` string, date, required: Requested fiscal-period end date.
    - `period_type` 'standalone_fiscal_quarter' | 'fiscal_year': Whether the requested value is one standalone fiscal quarter or the full fiscal year.
    - `as_of_date` string, date: 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` boolean: When true, report later different values for the same SEC concept, unit, and period separately from the primary anchored value.
    - `comparison_accession` string: 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` string: 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` string: Optional exact EX-99 exhibit filename or safe relative path when an 8-K contains multiple candidate earnings-release exhibits.

## Response `200`

financial-fact-reconciliation.v1

- object
  - `schemaVersion` 'financial-fact-reconciliation.v1', required
  - `operation` 'filedproof.reconcile_financial_fact', required
  - `resultId` string, required
  - `status` 'resolved' | 'ambiguous' | 'unsupported' | 'unavailable', required
  - `canonicalRequest` object, required
  - `issuer` object, required
  - `resolvedMetric` object, required
  - `value` string, nullable, required
  - `currency` string, nullable, required
  - `scale` integer, nullable
  - `units` string, nullable
  - `period` object, required
  - `asOf` object, required
  - `scope` object, required
  - `resultBasis` 'direct' | 'derived' | 'null', nullable, required
  - `derivation` object, nullable, required
  - `evidence` unknown[], required
    - unknown
  - `originalReported` object, nullable, required
  - `subsequentReportedValues` unknown[], required
    - unknown
  - `revisionAssessment` object, required
  - `validation` object, required
  - `limitations` string[], required
  - `unresolvedQuestions` string[], required
  - `source` object, required
  - `anchorFiling` object, required
  - `numberReconciliation` object, nullable

## Other responses

- `402`: Payment challenge only after deterministic eligibility is established. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED.
- `409`: Ambiguous/recast context; no payment challenge.
- `422`: Unsupported or unavailable context; no payment challenge.
- `503`: Payment provider/runtime unavailable.

---

[API](https://skmtc.dev/davisvillelabs/apis/filedproof-agent-research-api.md) · [All operations](https://skmtc.dev/davisvillelabs/apis/filedproof-agent-research-api/llms.txt) · [OpenAPI document](https://skmtc.dev/davisvillelabs/apis/filedproof-agent-research-api/revisions/16aba105f233?raw)