> ## 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 Stock KPI Values > **Feature Overview** [OpenAPI JSON Spec](/docs/output/v1_stocks_company_kpi_get.json) Retrieve KPI (Key Performance Indicators) values for a specific stock by fiscal year and quarter. **Main Use Cases** - **Financial Analysis**: Analyze company KPI trends over time - **Investment Research**: Review key performance metrics for investment decisions - **Quarterly Comparison**: Compare KPIs across different periods - **Performance Tracking**: Monitor company performance indicators **Parameters** | Parameter | Type | Required | Description | |------------------|--------|----------|-------------------------------------------------------| | symbol | string | Yes | Stock symbol (e.g., AAPL, NVDA) | | fiscal_year | int | Yes | Fiscal year | | fiscal_quarter | string | Yes | Fiscal quarter: Q1, Q2, Q3, Q4 for quarterly; FY for annual | **Response Data Description** Each KPI record includes: - **symbol**: Stock symbol - **periodType**: Period type (annual/quarterly) - **periodId**: Unique period identifier - **calendarEndDate**: Report date (YYYY-MM-DD) - **calendarYear**: Calendar year - **calendarQuarter**: Calendar quarter - **fiscalYear**: Fiscal year - **fiscalQuarter**: Fiscal quarter - **createdAt**: Ingestion time — when we first stored this record (RFC3339) - **values**: KPI values as JSON object **Usage Examples** 1. **Get Q2 FY2024 KPIs for Apple**: `?symbol=AAPL&fiscal_year=2024&fiscal_quarter=Q2` 2. **Get full year FY2024 KPIs for NVIDIA**: `?symbol=NVDA&fiscal_year=2024&fiscal_quarter=FY` **Important Notes** - Symbol parameter must be uppercase - Fiscal quarter values: Q1, Q2, Q3, Q4 (quarterly data), or FY (annual data) ## OpenAPI ````yaml /api-reference/openapi.json get /v1/stocks/company/kpi 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/kpi: get: tags: - Stock summary: Get Stock KPI Values description: >- **Feature Overview** [OpenAPI JSON Spec](/docs/output/v1_stocks_company_kpi_get.json) Retrieve KPI (Key Performance Indicators) values for a specific stock by fiscal year and quarter. **Main Use Cases** - **Financial Analysis**: Analyze company KPI trends over time - **Investment Research**: Review key performance metrics for investment decisions - **Quarterly Comparison**: Compare KPIs across different periods - **Performance Tracking**: Monitor company performance indicators **Parameters** | Parameter | Type | Required | Description | |------------------|--------|----------|-------------------------------------------------------| | symbol | string | Yes | Stock symbol (e.g., AAPL, NVDA) | | fiscal_year | int | Yes | Fiscal year | | fiscal_quarter | string | Yes | Fiscal quarter: Q1, Q2, Q3, Q4 for quarterly; FY for annual | **Response Data Description** Each KPI record includes: - **symbol**: Stock symbol - **periodType**: Period type (annual/quarterly) - **periodId**: Unique period identifier - **calendarEndDate**: Report date (YYYY-MM-DD) - **calendarYear**: Calendar year - **calendarQuarter**: Calendar quarter - **fiscalYear**: Fiscal year - **fiscalQuarter**: Fiscal quarter - **createdAt**: Ingestion time — when we first stored this record (RFC3339) - **values**: KPI values as JSON object **Usage Examples** 1. **Get Q2 FY2024 KPIs for Apple**: `?symbol=AAPL&fiscal_year=2024&fiscal_quarter=Q2` 2. **Get full year FY2024 KPIs for NVIDIA**: `?symbol=NVDA&fiscal_year=2024&fiscal_quarter=FY` **Important Notes** - Symbol parameter must be uppercase - Fiscal quarter values: Q1, Q2, Q3, Q4 (quarterly data), or FY (annual data) parameters: - description: Stock symbol (uppercase, e.g., AAPL) in: query name: symbol required: true schema: type: string - description: Fiscal year in: query name: fiscal_year required: true schema: type: integer - description: Fiscal quarter (Q1/Q2/Q3/Q4 for quarterly, FY for annual) in: query name: fiscal_quarter required: true schema: type: string enum: - Q1 - Q2 - Q3 - Q4 - FY responses: '200': description: Successfully retrieved KPI values content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.StockKpiValue' 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.StockKpiValue: properties: calendar_end_date: description: Report date (YYYY-MM-DD) type: string calendar_quarter: description: Calendar quarter (Q1, Q2, Q3, Q4) type: string calendar_year: description: Calendar year type: integer created_at: description: Ingestion time — when we first stored this record (RFC3339) example: '2024-01-15T10:00:00Z' type: string fiscal_quarter: description: Fiscal quarter (Q1, Q2, Q3, Q4) type: string fiscal_year: description: Fiscal year type: integer metrics: description: KPI metrics as an array of name-value pairs items: type: object type: array period_id: description: Unique period identifier type: string period_type: description: Period type (annual, quarterly) type: string symbol: description: Stock symbol type: string updated_at: description: Last update time of this record (RFC3339) example: '2024-01-15T10:00:00Z' type: string 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.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 ````