SEC Financial Reports API Documentation

Access standardized financial statement data from SEC filings for 1000+ of publicly traded companies.

Table of Contents

• Quick Start
• Authentication
• Base URL
• Endpoints
• Query Parameters
• Response Format
• Data Fields
• Subscription Tiers
• Error Handling
• Rate Limits
• Examples
• FAQ

---

Quick Start

Get Apple's revenue and profitability for Q3 2024:

GET /performance?ticker=AAPL&year=2024&quarter=3

Get a snapshot of Microsoft's 2023 financial health, including asset/liability totals and debt maturity:

GET /position?ticker=MSFT&year=2023

---

Authentication

Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Get your API key → (Sign up for free)

---

Base URL

https://us-companies-sec-financial-statements.p.rapidapi.com/api/v1/

All endpoints are relative to this base URL.

---

Endpoints

/performance - Profitability Metrics

Core profitability metrics tracking top-line revenue through to operating and net margins.

Fields Returned:

• total_revenue (BASIC) - Total revenue before expenses
• net_income (BASIC) - Bottom-line profit after all expenses
• gross_profit (PRO) - Revenue minus cost of goods sold
• operating_profit (PRO) - Profit from core business operations
• manufacturing_costs (ULTRA) - Direct costs of production

Example:

GET /performance?ticker=AAPL&year=2024&quarter=2

---

/position - Balance Sheet Health

A snapshot of the company's financial health, including asset/liability totals and debt maturity.

Fields Returned:

• total_assets (BASIC) - Everything the company owns
• total_liabilities (BASIC) - Everything the company owes
• cash_on_hand (PRO) - Liquid cash and cash equivalents
• short_term_assets (ULTRA) - Assets convertible to cash within one year
• unpaid_bills (ULTRA) - Accounts payable to suppliers
• short_term_debt (ULTRA) - Obligations due within one year
• long_term_debt (ULTRA) - Debt due beyond one year

Example:

GET /position?cik=320193&year=2023

---

/shareholder-value - Investor Returns

Investor-centric metrics including per-share earnings, dividend distributions, and market valuation.

Fields Returned:

• earnings_per_share_basic (PRO) - Profit per share (basic calculation)
• earnings_per_share_diluted (PRO) - Profit per share (including potential dilution)
• dividend_per_share (PRO) - Cash dividend per share declared
• total_dividends_paid (PRO) - Total cash distributed to shareholders
• public_market_value (PRO) - Market value of publicly held shares

Example:

GET /shareholder-value?ticker=MSFT&year=2024&quarter=1

---

/capital-structure - Ownership & Scale

Detailed breakdown of share capital, retained earnings, and organizational scale metrics.

Fields Returned:

• total_shares_issued (PRO) - Number of shares outstanding
• total_retained_profit (ULTRA) - Cumulative earnings retained in the business
• employees_amount (ULTRA) - Total number of employees

Example:

GET /capital-structure?ticker=GOOGL&year=2024

---

/investments - Financial Holdings

A granular view of non-operational short and long-term financial holdings.

Fields Returned:

• short_term_investments (ULTRA) - Securities held for under one year
• long_term_investments (ULTRA) - Securities held for over one year

Example:

GET /investments?ticker=BRK-B&year=2024&quarter=2

---

Query Parameters

All endpoints accept the same query parameters:

Important Notes:

• You must provide either ticker OR cik (not both)
• Q4 data is not available: Companies file annual reports (10-K) instead of Q4 reports. Omit the quarter parameter to get full-year data.
• Fiscal year matters: Use the company's fiscal year, not calendar year. For example, Apple's FY2024 ends in September 2024.

Valid Requests:

✅ GET /performance?ticker=AAPL&year=2024&quarter=3
✅ GET /position?cik=320193&year=2023
✅ GET /shareholder-value?ticker=TSLA&year=2024

Invalid Requests:

❌ GET /performance?ticker=AAPL&year=2024&quarter=4 - Q4 not allowed
❌ GET /position?year=2024 - Missing ticker or CIK
❌ GET /shareholder-value?ticker=AAPL - Missing year

---

Response Format

Success Response (200 OK)

{
	"ok": true,
	"data": {
		"company_name": "Apple Inc.",
		"ticker": "AAPL",
		"cik": 320193,
		"exchange": "Nasdaq",
		"fiscal_period": "FY2020Q2",
		"form": "10-Q",
		"data": {
			"total_shares_issued": {
				"value": "4,323,987,000",
				"period_end": "2020-03-28",
				"date_filed": "2020-05-01",
				"accession_number": "0000320193-20-000052",
				"unit": "shares",
				"alias": "Common Stock Shares Outstanding"
			},
			"total_retained_profit": {
				"value": "33,182,000,000",
				"period_end": "2020-03-28",
				"date_filed": "2020-05-01",
				"accession_number": "0000320193-20-000052",
				"unit": "USD",
				"alias": "Retained Earnings Accumulated Deficit"
			}
		}
	}
}

Field Object Structure

Each field in the data object contains:

Missing Data

If a field is not available in the SEC filing:

{
  "data": {
    "total_revenue": { ... },
    "gross_profit": "No SEC filing information"
  }
}

---

Data Fields

Complete Field Reference

---

Subscription Tiers

🆓 BASIC (Free)

• 10 requests per day
• Core financial metrics
• Historical data up to 1999

Fields Included:

• Total Revenue
• Net Income
• Total Assets
• Total Liabilities

💎 PRO ($8/month)

• Unlimited requests per day
• Advanced profitability & investor metrics
• HHistorical data up to 1999

Everything in BASIC, plus:

• Gross Profit
• Operating Profit
• Cash on Hand
• Earnings Per Share (Basic & Diluted)
• Dividends Per Share
• Total Dividends Paid
• Public Market Value
• Total Shares Issued

🚀 ULTRA ($30/month)

• Unlimited requests per day
• Complete balance sheet breakdown
• Investment holdings
• Historical data up to 1999

Everything in PRO, plus:

• Manufacturing Costs
• Short-term Assets
• Unpaid Bills
• Short-term Debt
• Long-term Debt
• Total Retained Profit
• Employee Count
• Short-term Investments
• Long-term Investments

---

Error Handling

Error Response Format

{
	"error": {
		"code": "INVALID_TICKER",
		"message": "Ticker must be text e.g. AAPL for Apple or GOOG for Google",
		"status": 400
	}
}

Common Error Codes

---

Rate Limits

Rate limits vary by subscription tier:

---

Examples

N.B: Please note these examples are mock data and not the actual financial data for these companies

Example 1: Get Apple's Quarterly Performance

Request:

curl -X GET "https://us-companies-sec-financial-statements.p.rapidapi.com/api/v1/financials/performance?ticker=AAPL&year=2024&quarter=2"

Response:

{
	"company_name": "Apple Inc.",
	"ticker": "AAPL",
	"cik": 320193,
	"exchange": "NASDAQ",
	"fiscal_period": "FY2024Q2",
	"form": "10-Q",
	"data": {
		"total_revenue": {
			"period_start": "2023-12-31",
			"period_end": "2024-03-30",
			"date_filed": "2024-05-02",
			"accession_number": "0000320193-24-000056",
			"value": "90,000,000,000",
			"unit": "USD",
			"alias": "Revenues"
		},
		"net_income": {
			"period_start": "2023-12-31",
			"period_end": "2024-03-30",
			"date_filed": "2024-05-02",
			"accession_number": "0000320193-24-000056",
			"value": "23,000,000,000",
			"unit": "USD",
			"alias": "Net Income (Loss)"
		}
	}
}

---

Example 2: Get Tesla's Annual Balance Sheet

Request:

curl -X GET "https://us-companies-sec-financial-statements.p.rapidapi.com/api/v1/financials/position?ticker=TSLA&year=2023" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
	"company_name": "Tesla, Inc.",
	"ticker": "TSLA",
	"cik": 1318605,
	"exchange": "NASDAQ",
	"fiscal_period": "FY2023",
	"form": "10-K",
	"data": {
		"total_assets": {
			"period_end": "2023-12-31",
			"date_filed": "2024-01-29",
			"accession_number": "0001318605-24-000006",
			"value": "106,000,000,000",
			"unit": "USD",
			"alias": "Assets"
		},
		"total_liabilities": {
			"period_end": "2023-12-31",
			"date_filed": "2024-01-29",
			"accession_number": "0001318605-24-000006",
			"value": "43,000,000,000",
			"unit": "USD",
			"alias": "Liabilities"
		},
		"cash_on_hand": {
			"period_end": "2023-12-31",
			"date_filed": "2024-01-29",
			"accession_number": "0001318605-24-000006",
			"value": "29,000,000,000",
			"unit": "USD",
			"alias": "Cash and Cash Equivalents"
		}
	}
}

---

Example 3: Get Berkshire Hathaway's Investments (Using CIK)

Request:

curl -X GET "https://us-companies-sec-financial-statements.p.rapidapi.com/api/v1/financials/investments?cik=1067983&year=2024&quarter=3"

Response:

{
	"company_name": "BERKSHIRE HATHAWAY INC",
	"ticker": "BRK-B",
	"cik": 1067983,
	"exchange": "NYSE",
	"fiscal_period": "FY2024Q3",
	"form": "10-Q",
	"data": {
		"long_term_investments": {
			"period_end": "2024-09-30",
			"date_filed": "2024-11-02",
			"accession_number": "0001193125-24-000123",
			"value": "326,000,000,000",
			"unit": "USD",
			"alias": "Equity Securities (Fair Value)"
		}
	}
}

---

FAQ

Q: What's the difference between fiscal year and calendar year?

A: Many companies use fiscal years that don't match the calendar year. For example:

• Apple: Fiscal year ends in September (FY2024 = Oct 2023 - Sep 2024)
• Microsoft: Fiscal year ends in June (FY2024 = Jul 2023 - Jun 2024)
• Walmart: Fiscal year ends in January (FY2024 = Feb 2023 - Jan 2024)

Always use the company's fiscal year in your queries.

---

Q: Why can't I get Q4 data?

A: Companies don't file Q4 quarterly reports (10-Q). Instead, they file annual reports (10-K) that cover the entire fiscal year. To get "Q4" data, you would need to subtract Q1-Q3 from the annual total.

Solution: Omit the quarter parameter to get full-year data:

GET /performance?ticker=AAPL&year=2024

---

Q: What does "No SEC filing information" mean?

A: This means the specific field was not reported in the company's SEC filing. This can happen for several reasons:

1. Not applicable to the business model - e.g., Berkshire Hathaway doesn't report gross profit
2. Industry-specific reporting - Banks don't report "cost of goods sold"
3. Company choice - Some companies don't report certain optional metrics

This is not an API error - it reflects the actual SEC filing.

---

Q: How do I find a company's CIK?

A: You can search for a CIK on the SEC's website:

1. Go to sec.gov/edgar/searchedgar/companysearch
2. Enter the company name
3. The CIK is shown in the search results

Common CIKs:

• Apple: 320193
• Microsoft: 789019
• Amazon: 1018724
• Tesla: 1318605
• Berkshire Hathaway: 1067983

---

Q: What units are used for financial data?

A: The API returns three unit types:

• USD - U.S. Dollars (for monetary values)
• shares - Number of shares (for share counts)
• pure - No units (for employee counts, ratios)

All monetary values are in U.S. Dollars, even for international companies.

---

Q: How current is the data?

A: Data is updated within 24 hours of a company filing with the SEC. Companies typically file:

• Quarterly reports (10-Q): Within 40-45 days after quarter end
• Annual reports (10-K): Within 60-90 days after fiscal year end

---

Q: Can I get historical data?

A: Yes! Historical data availability depends on the company's filing history with earliest history being up to 1994

---

Q: Do you support international companies?

A: Yes as long as that company files with the U.S. SEC, and is among the top 1000+ companies:

All data is standardized to USD.

---

Q: How do I report an issue or request a feature?

A: Contact us at:

• Email: support@regora.net

---

Need Help?

• 📧 Email: support@regora.net

---

Last Updated: February 2026
API Version: v1