WritersLogic Verifiable AI Agent Hub Filing Integrity Check API
The Filing Integrity Check API from WritersLogic Verifiable AI Agent Hub — 1 operation(s) for filing integrity check.
Work with this as data
Every API 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 apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/writerslogic-com:writerslogic-com-filing-integrity-check-api"
All apis
curl "https://apis.io/api/v1/apis?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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: WritersLogic Verifiable AI Agent Hub Filing Integrity Check…
version: 2.0.0
description: Pay-per-call agents settled in USDC on Base via x402. Every response carries a signed provenance envelope.
contact:
name: WritersLogic
url: https://writerslogic.com/agents
email: agents@writerslogic.com
servers:
- url: https://agents.writerslogic.com
tags:
- name: Filing Integrity Check
paths:
/api/v1/filing-integrity-check:
post:
operationId: filing_integrity_check
summary: 'SEC Filing Integrity Check: XBRL Footing, Tie-Outs, Revisions'
description: 'Before a figure from a US 10-K or 10-Q is quoted, re-checks it with exact integer arithmetic on SEC XBRL data: balance sheet identity (including noncontrolling and temporary equity), net income bridge, cash flow to balance sheet cash tie-out with restricted cash and roll-forward, EPS recomputation, every calculation-linkbase relationship the filing declares, and same-period values that a later 10-K/10-Q reports differently (disclosure-rounding differences excluded) plus Item 4.02 non-reliance 8-Ks. Returns per-check PASS, FAIL, NOT_APPLICABLE or INSUFFICIENT_DATA with expected, actual, delta and the smallest line-item set that explains each gap, and the SHA-256 of every SEC document read. No LLM. Limits: non-dimensional facts only (SEC companyfacts omits extension concepts and dimensional data), US GAAP 10-K/10-Q filers, and a revision is reported without a cause. Not legal, accounting, audit or investment advice.
Price: 1.00 USDC on Base (x402).'
x-x402-price-usdc: '1.00'
x-x402-amount: '1000000'
x-payment-info:
protocols:
- x402
price:
mode: fixed
currency: USD
amount: '1.00'
x-audience: business
x-sample-url: https://agents.writerslogic.com/api/v1/samples/filing-integrity-check
security:
- x402: []
- apiKey: []
requestBody:
required: true
content:
application/json:
schema:
type: object
additionalProperties: false
properties:
ticker:
type: string
minLength: 1
maxLength: 12
description: Exchange ticker, e.g. AAPL or BRK.B. Give exactly one of ticker or cik.
cik:
type: string
minLength: 1
maxLength: 10
pattern: ^[0-9]{1,10}$
description: SEC CIK, digits only.
accession:
type: string
minLength: 18
maxLength: 20
description: Accession number of a 10-K or 10-Q, e.g. 0000320193-25-000079. Give this or fiscal_year with period.
fiscal_year:
type: integer
minimum: 2009
maximum: 2100
description: Fiscal year of the filing's DocumentFiscalYearFocus.
period:
type: string
enum:
- FY
- Q1
- Q2
- Q3
description: FY selects the 10-K; Q1 to Q3 select 10-Qs (there is no Q4 filing).
checks:
type: array
minItems: 1
maxItems: 6
items:
type: string
enum:
- balance_identity
- net_income_tie_out
- cash_tie_out
- eps_recomputation
- restatement_scan
- calculation_footing
description: Checks to run; default all six.
rounding_mode:
type: string
enum:
- exact
- reported_precision
description: 'exact: any nonzero difference fails. reported_precision (default): differences within half a unit of the filing''s reporting scale per rounded figure pass and are flagged.'
example:
ticker: AAPL
fiscal_year: 2025
period: FY
responses:
'200':
description: Paid result with provenance
content:
application/json:
schema:
type: object
properties:
data:
type: object
required:
- verdict
- confidence
- summary
- next_step
- at_stake
- filing
- checks
- restatements
- source_manifest
- top_evidence
- not_run
- partial
- disclaimer
properties:
verdict:
type: string
enum:
- CLEAN
- ARITHMETIC_FAILURE
- REVISION_FLAGGED
- INCONCLUSIVE
description: 'ARITHMETIC_FAILURE: a footing or tie-out check failed. REVISION_FLAGGED: statements foot but a later 10-K/10-Q reports a primary-statement value of this filing differently, or an Item 4.02 notice followed. CLEAN: all applicable checks passed. INCONCLUSIVE: some check lacked data.'
confidence:
type: number
description: Share of applicable checks that reached PASS or FAIL, times 0.97.
summary:
type: string
next_step:
type: string
at_stake:
type: object
properties:
largest_discrepancy_usd:
anyOf:
- type: string
- type: 'null'
largest_discrepancy_check:
anyOf:
- type: string
- type: 'null'
failing_checks:
type: array
items:
type: string
core_revisions:
type: integer
description: Primary-statement values in this filing that a later 10-K/10-Q reports differently.
earlier_filings_revised:
type: integer
description: Primary-statement values this filing reports differently from an earlier 10-K/10-Q (informational; does not affect the verdict).
largest_core_revision_usd:
anyOf:
- type: string
- type: 'null'
filing:
type: object
properties:
cik:
type: string
accession:
type: string
form:
type: string
filed:
type: string
fiscal_year:
anyOf:
- type: integer
- type: 'null'
fiscal_period:
anyOf:
- type: string
- type: 'null'
period_end:
type: string
index_url:
type: string
other_accessions_same_period:
type: array
items:
type: string
checks:
type: array
items:
type: object
required:
- id
- status
- explanation
- expected
- actual
- delta
- concepts
- explanation_subset
- comparisons
properties:
id:
type: string
enum:
- balance_identity
- net_income_tie_out
- cash_tie_out
- eps_recomputation
- restatement_scan
- calculation_footing
status:
type: string
enum:
- PASS
- FAIL
- NOT_APPLICABLE
- INSUFFICIENT_DATA
explanation:
type: string
expected:
anyOf:
- type: string
- type: 'null'
actual:
anyOf:
- type: string
- type: 'null'
delta:
anyOf:
- type: string
- type: 'null'
concepts:
type: array
items:
type: string
explanation_subset:
type: array
items:
type: object
additionalProperties: false
required:
- label
- amount
- relation
properties:
label:
type: string
amount:
type: string
relation:
type: string
description: Smallest set of line items (up to three) whose exact sum equals the gap.
comparisons:
type: array
items:
type: object
additionalProperties: false
required:
- label
- period
- status
- expected
- actual
- delta
- within_rounding
- concepts
- explanation_subset
- note
properties:
label:
type: string
period:
type: string
status:
type: string
enum:
- PASS
- FAIL
- NOT_APPLICABLE
- INSUFFICIENT_DATA
expected:
anyOf:
- type: string
- type: 'null'
description: Value implied by the other facts.
actual:
anyOf:
- type: string
- type: 'null'
description: Value as reported.
delta:
anyOf:
- type: string
- type: 'null'
description: actual minus expected, exact decimal.
within_rounding:
type: boolean
concepts:
type: array
items:
type: string
explanation_subset:
type: array
items:
type: object
additionalProperties: false
required:
- label
- amount
- relation
properties:
label:
type: string
amount:
type: string
relation:
type: string
description: Smallest set of line items (up to three) whose exact sum equals the gap.
note:
type: string
restatements:
type: array
description: Same concept and period with different values in two 10-K/10-Q filings, one of them this filing. Disclosure-precision differences are excluded; cause is not determined.
items:
type: object
properties:
concept:
type: string
period:
type: string
unit:
type: string
original:
type: object
additionalProperties: false
required:
- accession
- filed
- form
- value
properties:
accession:
type: string
filed:
type: string
form:
type: string
value:
type: string
later:
type: object
additionalProperties: false
required:
- accession
- filed
- form
- value
properties:
accession:
type: string
filed:
type: string
form:
type: string
value:
type: string
delta:
type: string
description: later minus original.
this_filing:
type: string
enum:
- original
- later
core:
type: boolean
restatement_summary:
type: object
non_reliance_notices:
type: array
items:
type: object
non_reliance_scan_from:
anyOf:
- type: string
- type: 'null'
footing_coverage:
type: object
reported_scale_usd:
type: string
rounding_mode:
type: string
data_scope:
type: string
enum:
- companyfacts
- companyconcept
not_run:
type: array
items:
type: object
properties:
check:
type: string
reason:
type: string
partial:
type: boolean
top_evidence:
type: array
items:
type: object
properties:
finding:
type: string
source_url:
type: string
source_sha256:
type: string
source_manifest:
type: array
items:
type: object
properties:
role:
type: string
url:
type: string
sha256:
type: string
bytes:
type: integer
llm:
type: string
enum:
- not_used
disclaimer:
type: string
_provenance:
type: object
description: C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance
required:
- data
- _provenance
'400':
description: Invalid request (no payment consumed)
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
'401':
description: Invalid X-API-KEY
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
'402':
description: Payment required or invalid
content:
application/json:
schema:
type: object
description: x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)
properties:
x402Version:
type: integer
error:
type: string
code:
type: string
resource:
type: object
accepts:
type: array
items:
type: object
extensions:
type: object
'502':
description: Upstream failure; the payment is released or not settled
content:
application/json:
schema:
type: object
properties:
error:
type: string
code:
type: string
tags:
- Filing Integrity Check
components:
securitySchemes:
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: x402 v2 payment payload (base64) sent after a 402 challenge
apiKey:
type: apiKey
in: header
name: X-API-KEY