Get Company Income Statements
OpenAPI JSON Spec Retrieve income statements for a specific company within a time range Feature Overview Get detailed financial statements including revenue, net income, EPS, and other key metrics for a specific company over a specified time period. Main Use Cases
- Financial Analysis: Analyze company’s financial performance over time
- Investment Research: Review historical financial data for investment decisions
- Quarterly Reports: Access quarterly and annual financial statements
- Trend Analysis: Track financial metrics trends over time
Parameters
- symbol: Stock symbol (required, e.g., NVDA, AAPL)
- start_time: Start time (required, Unix timestamp in seconds)
- end_time: End time (required, Unix timestamp in seconds)
- period_type: Period type (optional, annual/quarter; if omitted, returns both annual & quarter)
- time_type: Time type for filtering (required)
CALENDAR_END_DATE: Filter by Date (calendarEndDate) fieldFILING_DATE: Filter by FilingDate fieldOBSERVED_AT: Filter by publish_time field
Response Data Returns an array of financial statements with:
- calendarEndDate: Statement date (YYYY-MM-DD format)
- observedAt: Observed timestamp (Unix seconds)
- Revenue: Total revenue
- Net Income: Net income/loss
- EPS: Earnings per share
- Other metrics: Additional financial indicators
Usage Examples
-
Get income statements for NVDA in 2024:
?symbol=NVDA&start_time=1704067200&end_time=1735689599&period_type=quarter -
Get annual income statements:
?symbol=AAPL&start_time=1704067200&end_time=1735689599&period_type=annual
Best Practices
- Use specific time ranges to limit data size and improve performance
- Cache frequently requested financial data
- Consider pagination for large datasets
Important Notes
- Ticker parameter (e.g., NVDA, AAPL)
- Time parameters are Unix timestamps in seconds
- end_time must be greater than start_time
- Financial data may have reporting delays
Authorizations
API Key authentication. Example: "your-api-key-here"
Query Parameters
Stock symbol (uppercase, e.g., NVDA, AAPL)
Start time (Unix timestamp in seconds)
End time (Unix timestamp in seconds). Must be greater than start_time
Reporting period type. Omit to return both annual and quarter data
annual, quarter Time dimension used for filtering. Defaults to OBSERVED_AT. CALENDAR_END_DATE: the last day of the reporting period; FILING_DATE: the date filed with regulators; OBSERVED_AT: the timestamp the data was first ingested (point-in-time safe)
CALENDAR_END_DATE, FILING_DATE, OBSERVED_AT 
