---
title: "Check whether an SEC financial fact can be safely reconciled before payment"
method: POST
path: "/v1/research/financial-fact/preflight"
---

# Check whether an SEC financial fact can be safely reconciled before payment

`POST /v1/research/financial-fact/preflight`

## Request

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

Free. Resolves ticker/name/CIK to the durable SEC CIK, validates or selects the filing, checks metric and requested quarter/fiscal-year context, verifies required SEC Company Facts inputs, and when requested verifies that the SEC-filed 8-K comparison source is usable. Does not reveal the filing value, comparison source value, source evidence, later revision values, or arithmetic.

## 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-preflight.v1

- object
  - `schemaVersion` 'financial-fact-preflight.v1', required
  - `operation` 'filedproof.reconcile_financial_fact', required
  - `canonicalRequest` object, required
  - `status` 'eligible' | 'ineligible', required
  - `eligible` boolean, required
  - `checks` object, required
  - `price` object, required
  - `paymentMethods` string[], required
  - `reason` string
  - `disclosureBoundary` string, required

---

[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)