Access Structured XBRL Data for Corporate Filings

This API supports a wide range of use cases, empowering developers and analysts to build powerful financial tools. It enables automated financial reporting by generating statements like balance sheets and income statements, ensures regulatory compliance through standardized data extraction, and supports financial modeling for performance trend analysis. It also powers investor dashboards with key metrics like earnings per share and facilitates seamless data integration into ERP systems for auditing and planning. Additionally, AI-driven applications can leverage the API for predictive financial modeling, using machine learning to forecast trends based on historical XBRL data, and for automated anomaly detection to identify irregularities in financial filings for compliance or fraud prevention.

Key Features

• 📋 Structured XBRL Data Access - Extract machine-readable financial data from filings.
  Users can retrieve structured XBRL data for specific filings by providing a filingId, enabling precise extraction of financial metrics like revenues, assets, or ratios. This feature supports applications requiring standardized data for financial modeling or regulatory reporting.

• 📊 Comprehensive Data Fields - Access detailed XBRL attributes for in-depth analysis.
  Each response includes fields like item, namespace, value, decimals, and unit, providing a complete view of financial data points. This granularity supports complex use cases like ratio analysis or cross-filing comparisons.

• 📅 Flexible Date Range Support - Retrieve data with specific start and end dates.
  The API provides startDate and endDate fields to define the temporal scope of each data point, enabling users to analyze financial metrics over specific periods. This is ideal for applications tracking quarterly or annual performance trends.

• 🔐 Secure Authentication - Protect access with a Base64-encoded application key.
  The API requires a T parameter for authentication, ensuring secure and authorized access to sensitive filing data. This allows developers to confidently integrate the API into production environments, safeguarding financial applications.

Available Data Fields

Each API call returns a collection of data rows with the following columns. Always reference the columns array when parsing to ensure correct data mapping, as column order may vary.

Column	Meaning	Data Type
item	The XBRL item name	String
namespace	The XBRL Taxonomy in which the Item is based	String
value	The value of the item	String
decimals	The number of decimal places for the item (*iXBRL only)	Number
scale	The scale of the item (*iXBRL only)	Number
format	The format of the item (*iXBRL only)	String
sign	The sign of the item (*iXBRL only)	String
endDate	The end of the data range for which the item applies	Date String (YYYY-MM-DD)
startDate	The start of the data range for which the item applies, or null for single-date items	Date String (YYYY-MM-DD) or null
unit	The unit of measurement for the item	String
unitNamespace	The namespace of the unit of measurement for the item	String
divisor	The divisor for ratio items (e.g., USD per Share), or null	String
divisorNamespace	The namespace of the unit of measurement for the divisor	String

*Reference for iXBRL elements: XBRL Precision, Decimals, and Units

Query Parameters

The API accepts the following parameters to customize your request:

Parameter	Meaning	Data Type
T	Application Key which authenticates you with CloudQuote (required)	Base64 String
filingId	The filingId to retrieve data for (required)	Number

Use Cases

• 📊 Financial Reporting Automation - Streamline the creation of financial statements and reports.
  Developers can extract XBRL data to automate the generation of balance sheets, income statements, or cash flow reports, using fields like value and unit to ensure accuracy. This reduces manual data entry for accounting teams and enhances reporting efficiency.

• 🔍 Regulatory Compliance Analysis - Ensure compliance with structured filing data.
  Analysts can use the API to retrieve standardized XBRL data for specific filings, enabling automated compliance checks against regulatory requirements. Fields like namespace and decimals ensure precision in meeting reporting standards.

• 🧠 Financial Modeling and Research - Build robust models with granular XBRL data.
  Researchers can leverage fields like item, value, and endDate to construct financial models or analyze corporate performance trends. This supports applications like valuation models or comparative financial analysis across companies.

• 📈 Investor Dashboards - Display key financial metrics for investors.
  Developers can integrate XBRL data into dashboards to showcase metrics like earnings per share or total assets, using divisor and unit for ratio-based insights. This enhances investor portals with clear, data-driven visualizations.

• 🔧 Data Integration for ERP Systems - Seamlessly incorporate filing data into enterprise platforms.
  The API’s structured output allows integration of XBRL data into ERP systems for financial planning or auditing, using fields like startDate and endDate to align data with fiscal periods. This streamlines enterprise workflows.

Why Choose FinancialContent's getFilingStructuredData API?

• 🚀 Unmatched Reliability - Dependable access to critical financial data.
  Built on a fault-tolerant infrastructure, the API ensures 99.99% uptime, delivering filing data reliably even during high-demand periods. This supports mission-critical applications like compliance reporting or investor tools.

• 🔄 Seamless XBRL Integration - Effortlessly combine with other financial datasets.
  The API supports integration with FinancialContent’s other data feeds, enabling users to blend XBRL filing data with market or tick data. This is ideal for comprehensive platforms requiring both financial and market insights.

• 📈 Scalable Data Processing - Handle large volumes of filing data with ease.
  Designed to process complex XBRL datasets across multiple filings, the API scales efficiently for enterprise-grade applications, from small research tools to large compliance platforms.

• 📚 Developer-Friendly Resources - Comprehensive support for smooth integration.
  FinancialContent provides detailed documentation, sample code, and responsive support to ensure developers can quickly implement the API. From setup to advanced use cases, our team is here to help.

Optimized for High-Speed Access

The getFilingStructuredData API is designed for peak performance, adhering to industry best practices for rapid data delivery. Our RESTful endpoints use efficient JSON formatting to minimize payload size, enabling fast parsing and reduced bandwidth usage. Advanced caching accelerates repeated queries, while globally distributed servers reduce latency for users worldwide. Rate limiting and pagination maintain stability under heavy loads, and asynchronous request handling ensures smooth processing of complex XBRL datasets. This performance-driven design empowers developers to build responsive, data-intensive applications with minimal delays.

Sample Request

GET /api/getFilingStructuredData?T=your_base64_key&filingId=123456

Sample Response (JSON)

{
  "columns": ["item", "namespace", "value", "decimals", "scale", "format", "sign", "endDate", "startDate", "unit", "unitNamespace", "divisor", "divisorNamespace"],
  "rows": [
    ["NetIncome", "us-gaap", "1500000", 2, 0, "num", "+", "2025-06-30", "2025-04-01", "USD", "iso4217", null, null],
    ["EarningsPerShare", "us-gaap", "2.50", 2, 0, "num", "+", "2025-06-30", null, "USDPerShare", "iso4217", "Share", "us-gaap"],
    ...
  ]
}