> ## Documentation Index > Fetch the complete documentation index at: https://docs.arrays.org/llms.txt > Use this file to discover all available pages before exploring further. # Get Company Income Statements > [OpenAPI JSON Spec](/docs/output/v1_stocks_company_income-statements_get.json) 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) field - `FILING_DATE`: Filter by FilingDate field - `OBSERVED_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** 1. **Get income statements for NVDA in 2024**: `?symbol=NVDA&start_time=1704067200&end_time=1735689599&period_type=quarter` 2. **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 ## OpenAPI ````yaml /api-reference/openapi.json get /v1/stocks/company/income-statements openapi: 3.0.0 info: contact: {} description: >- Welcome to Arrays! Arrays is a unified financial data layer for both financial institutions and retail users, delivering comprehensive market data across crypto and equity markets. Our datasets cover fundamentals, ETFs, options, crypto, and more. Visit [arrays.org](https://arrays.org) to request an API key and start your free trial. You can explore our full API offerings in the documentation below. For any questions regarding APIs or pricing, please contact support@arrays.org. title: Arrays API version: '1.0' servers: - url: https://data-tools.prd.arrays.org/api security: [] paths: /v1/stocks/company/income-statements: get: tags: - Stock summary: Get Company Income Statements description: >- [OpenAPI JSON Spec](/docs/output/v1_stocks_company_income-statements_get.json) 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) field - `FILING_DATE`: Filter by FilingDate field - `OBSERVED_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** 1. **Get income statements for NVDA in 2024**: `?symbol=NVDA&start_time=1704067200&end_time=1735689599&period_type=quarter` 2. **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 parameters: - description: Stock symbol (uppercase, e.g., NVDA, AAPL) in: query name: symbol required: true schema: type: string - description: Start time (Unix timestamp in seconds) in: query name: start_time required: true schema: type: integer format: int64 - description: >- End time (Unix timestamp in seconds). Must be greater than start_time in: query name: end_time required: true schema: type: integer format: int64 - description: Reporting period type. Omit to return both annual and quarter data in: query name: period_type schema: type: string enum: - annual - quarter - description: >- 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) in: query name: time_type schema: type: string enum: - CALENDAR_END_DATE - FILING_DATE - OBSERVED_AT responses: '200': description: Successfully retrieved income statements content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: >- #/components/schemas/model.GetIncomeStatementByTimeIntervalResponse type: array type: object '400': description: Invalid parameters content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object security: - ApiKeyAuth: [] components: schemas: model.APIResponse: properties: data: {} error: $ref: '#/components/schemas/model.APIError' metadata: {} pagination: {} request_id: type: string success: type: boolean type: object model.GetIncomeStatementByTimeIntervalResponse: properties: data: description: Array of income statement data items: $ref: '#/components/schemas/model.IncomeStatementData' type: array total_count: description: Total count of records type: integer type: object model.APIError: properties: code: example: RESOURCE_NOT_FOUND type: string details: items: $ref: '#/components/schemas/model.APIErrorDetail' type: array docs_url: type: string examples: items: type: string type: array hint: type: string message: example: The requested resource was not found. type: string suggestions: items: type: string type: array type: object model.IncomeStatementData: properties: accepted_date: example: '2024-11-01 06:01:36' type: string bottom_line_net_income: type: number calendar_end_date: example: '2024-09-28' type: string cik: example: '0000320193' type: string cost_and_expenses: type: number cost_of_revenue: type: number created_at: type: string depreciation_and_amortization: type: number ebit: type: number ebitda: type: number eps: type: number eps_diluted: type: number filing_date: example: '2024-11-01' type: string fiscal_year: example: '2024' type: string gross_profit: type: number gross_profit_ratio: type: number id: example: 1 type: integer income_before_tax: type: number income_tax_expense: type: number interest_expense: type: number interest_income: type: number net_income: type: number net_income_deductions: type: number net_interest_income: type: number net_profit_ratio: type: number non_operating_income_excluding_interest: type: number observed_at: example: 1730419200 type: integer operating_expenses: type: number operating_income: type: number operating_profit_ratio: type: number other_adjustments_to_net_income: type: number other_expenses: type: number period: example: Q4 type: string reported_currency: example: USD type: string revenue: type: number symbol: example: AAPL type: string total_other_income_expenses_net: type: number updated_at: type: string weighted_average_shs_out: type: number weighted_average_shs_out_dil: type: number type: object model.APIErrorDetail: properties: field: type: string got: type: string reason: type: string type: object securitySchemes: ApiKeyAuth: description: 'API Key authentication. Example: "your-api-key-here"' in: header name: X-API-Key type: apiKey ````