> ## 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 Single Company Details

> **Feature Overview**
[OpenAPI JSON Spec](/docs/output/v1_stocks_company_detail_get.json)
Retrieve the profile of a single company based on stock symbol or company name keyword — identity, classification, and descriptive attributes. Suitable for company detail pages, company search, and more. Valuation and financial metrics are served by the dedicated `/stocks/market-metrics` and `/stocks/financial-metrics` endpoints.
**Main Use Cases**
- **Company Detail Pages**: Display the profile of a single company
- **Company Search**: Resolve a stock symbol or name keyword to a company profile
- **Mobile Applications**: Provide data interface for company detail pages
- **Desktop Software**: Provide company data for professional investment software

**Query Parameter Description**

Supports two query methods:
- **Exact Query**: Find company precisely by stock symbol
- **Fuzzy Query**: Fuzzy match by company name keyword

**Response Data Description**

The returned company profile includes:
- **Basic Info**: Stock symbol, company name, industry classification, exchange
- **Profile**: Description, website, CEO, employees, country, IPO date, listing flags (is_etf/is_adr/is_fund)

Valuation and financial metrics are **not** returned here — use `/stocks/market-metrics` (PE/PS/market cap) and `/stocks/financial-metrics` (revenue/EPS/ROE TTM).

**Usage Examples**

1. **Query Apple company by stock symbol**:
`?symbol=AAPL`

2. **Query by company name keyword**:
`?name_kw=Apple`

3. **Use both stock symbol and name keyword**:
`?symbol=AAPL&name_kw=Apple`

**Best Practices**

- Prioritize using stock symbol for exact queries, faster response
- Name keyword query supports fuzzy matching, suitable for search functionality
- Recommend caching query results for popular companies
- For mobile applications, preload data for commonly used companies

**Important Notes**

- Symbol parameter must be uppercase, e.g., AAPL, GOOGL
- name_kw parameter supports Chinese and English, case-insensitive
- If both symbol and name_kw are provided, symbol takes priority



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stocks/company/detail
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/detail:
    get:
      tags:
        - Stock
      summary: Get Single Company Details
      description: >-
        **Feature Overview**

        [OpenAPI JSON Spec](/docs/output/v1_stocks_company_detail_get.json)

        Retrieve the profile of a single company based on stock symbol or
        company name keyword — identity, classification, and descriptive
        attributes. Suitable for company detail pages, company search, and more.
        Valuation and financial metrics are served by the dedicated
        `/stocks/market-metrics` and `/stocks/financial-metrics` endpoints.

        **Main Use Cases**

        - **Company Detail Pages**: Display the profile of a single company

        - **Company Search**: Resolve a stock symbol or name keyword to a
        company profile

        - **Mobile Applications**: Provide data interface for company detail
        pages

        - **Desktop Software**: Provide company data for professional investment
        software


        **Query Parameter Description**


        Supports two query methods:

        - **Exact Query**: Find company precisely by stock symbol

        - **Fuzzy Query**: Fuzzy match by company name keyword


        **Response Data Description**


        The returned company profile includes:

        - **Basic Info**: Stock symbol, company name, industry classification,
        exchange

        - **Profile**: Description, website, CEO, employees, country, IPO date,
        listing flags (is_etf/is_adr/is_fund)


        Valuation and financial metrics are **not** returned here — use
        `/stocks/market-metrics` (PE/PS/market cap) and
        `/stocks/financial-metrics` (revenue/EPS/ROE TTM).


        **Usage Examples**


        1. **Query Apple company by stock symbol**:

        `?symbol=AAPL`


        2. **Query by company name keyword**:

        `?name_kw=Apple`


        3. **Use both stock symbol and name keyword**:

        `?symbol=AAPL&name_kw=Apple`


        **Best Practices**


        - Prioritize using stock symbol for exact queries, faster response

        - Name keyword query supports fuzzy matching, suitable for search
        functionality

        - Recommend caching query results for popular companies

        - For mobile applications, preload data for commonly used companies


        **Important Notes**


        - Symbol parameter must be uppercase, e.g., AAPL, GOOGL

        - name_kw parameter supports Chinese and English, case-insensitive

        - If both symbol and name_kw are provided, symbol takes priority
      parameters:
        - description: Stock symbol (uppercase, e.g., AAPL)
          in: query
          name: symbol
          schema:
            type: string
        - description: Company name keyword (English, case-insensitive)
          in: query
          name: name
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved company details
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.CompanyDetail'
                        type: array
                    type: object
        '400':
          description: Invalid parameters or missing required fields
          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.CompanyDetail:
      properties:
        ceo:
          example: Jensen Huang
          type: string
        cik:
          example: '0001045810'
          type: string
        company_description:
          example: NVIDIA Corporation provides graphics and compute solutions.
          type: string
        country:
          example: United States
          type: string
        employees:
          example: 29600
          type: integer
        exchange:
          example: NASDAQ
          type: string
        exchange_short_name:
          example: NASDAQ
          type: string
        industry:
          example: Semiconductors
          type: string
        ipo_date:
          example: '1999-01-22'
          type: string
        is_adr:
          example: false
          type: boolean
        is_etf:
          example: false
          type: boolean
        is_fund:
          example: false
          type: boolean
        is_listed:
          example: true
          type: boolean
        logo:
          example: https://example.com/logo.png
          type: string
        name:
          example: NVIDIA Corporation
          type: string
        sector:
          example: Technology
          type: string
        symbol:
          example: NVDA
          type: string
        website:
          example: https://www.nvidia.com
          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

````