📊 Statement Clarity - Financial Statement Parsing API

Statement Clarity is a powerful AI-driven API that transforms SEC filings and financial documents into structured, machine-readable JSON. Extract balance sheets, income statements, cash flows, and calculate key financial ratios automatically.

🚀 Quick Start

Access the API through RapidAPI. Authentication is handled automatically — just include your RapidAPI key in requests.

Base URL

https://statement-clarity.p.rapidapi.com

📡 API Endpoints

Endpoint	Method	Description
/health	GET	Check API status and version
/parse	POST	Submit a document for parsing
/parse-result	GET	Retrieve parsed results by job ID
/edgar-search	GET	Search SEC EDGAR filings by ticker
/batch-parse	POST	Process up to 50 documents at once
/xbrl-parse	POST	Parse XBRL-tagged documents
/compare	POST	Compare multiple parsed results
/export	GET	Export data as JSON or CSV

🔄 Async Processing Model

The API uses an asynchronous pattern for document parsing:

Submit a document via /parse → receive a jobId
Poll the /parse-result endpoint every 3-5 seconds
Retrieve structured JSON when status: "completed"

Typical processing time: 10-30 seconds depending on document complexity.

📝 Example Responses

Health Check

{
  "status": "ok",
  "version": "1.0.0",
  "service": "Statement Clarity API",
  "timestamp": "2026-01-30T12:00:00.000Z"
}

Parse Submission (202 Accepted)

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "message": "Parse job created successfully. Poll /parse-result for results.",
  "estimatedTime": "10-30 seconds"
}

Completed Parse Result

{
  "status": "completed",
  "result": {
    "company": "Apple Inc.",
    "symbol": "AAPL",
    "fiscalYear": 2023,
    "fiscalPeriod": "FY",
    "balanceSheet": {
      "totalAssets": 352583000000,
      "totalLiabilities": 290437000000,
      "totalEquity": 62146000000
    },
    "incomeStatement": {
      "revenue": 383285000000,
      "netIncome": 96995000000
    },
    "cashFlowStatement": {
      "operatingCashFlow": 110543000000,
      "freeCashFlow": 99584000000
    },
    "financialRatios": {
      "returnOnEquity": 1.56,
      "returnOnAssets": 0.275,
      "currentRatio": 0.988,
      "grossMargin": 0.441,
      "netMargin": 0.253
    },
    "confidence": 0.95
  }
}

📁 Supported Input Types

SEC EDGAR ID - Accession number (e.g., 0000320193-23-000106)
Document URL - Link to PDF or HTML financial statement
Raw Text - Pasted financial statement content
XBRL - Native parsing of XBRL-tagged documents

📊 Extracted Data

Category	Data Points
Balance Sheet	Total assets, liabilities, equity, cash, current assets, long-term debt
Income Statement	Revenue, gross profit, operating income, net income, EPS
Cash Flow	Operating, investing, financing cash flows, CapEx, dividends
Financial Ratios	Margins, ROE, ROA, current ratio, debt-to-equity, and more

🔐 Authentication

Authentication is handled automatically by RapidAPI. Simply include your RapidAPI key in the X-RapidAPI-Key header (done automatically when using the RapidAPI interface or code snippets).

💼 Use Cases

Financial Analysis - Extract standardized metrics for stock research and valuation models
Data Aggregation - Build financial databases by batch-processing historical SEC filings
Due Diligence - Rapidly process statements during M&A research or loan underwriting
FinTech Apps - Automate data ingestion for portfolio trackers and screening tools
Academic Research - Extract structured data from years of filings for backtesting

⚡ Key Features

95%+ Accuracy - AI-powered extraction with confidence scoring
Batch Processing - Submit up to 50 documents in a single request
SEC EDGAR Integration - Direct access to filings by accession number
XBRL Support - Native parsing of XBRL-tagged documents
Company Comparison - Compare financials across multiple companies
Flexible Export - JSON or CSV output formats

📧 Support

For questions or support, contact: statementclarity@protonmail.com

🔗 Links

Website: https://statement-clarity.org
Documentation: https://statement-clarity.org/public-docs
Terms of Service: https://statement-clarity.org/terms
Privacy Policy: https://statement-clarity.org/privacy

Statement Clarity — Transform Financial Documents into Structured Data