> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stockinsights.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Companies List

> Returns a paginated list of US companies with identifiers (CIK, ticker), exchange information, and industry classification. Supports filtering by ticker, CIK, sector, industry, market-cap category, and company ID. Defaults to sort by `company_name` ascending.



## OpenAPI

````yaml openapi-us get /api/us/v0/companies
openapi: 3.0.0
info:
  title: stockinsights.ai APIs
  description: All the APIs of stockinsights.ai
  version: 1.0.0
servers:
  - url: https://stockinsights-ai-us-main-f5fd25a.zuplo.app
security:
  - bearerAuth: []
paths:
  /api/us/v0/companies:
    get:
      summary: Companies List
      description: >-
        Returns a paginated list of US companies with identifiers (CIK, ticker),
        exchange information, and industry classification. Supports filtering by
        ticker, CIK, sector, industry, market-cap category, and company ID.
        Defaults to sort by `company_name` ascending.
      operationId: getCompanies
      parameters:
        - name: ticker
          in: query
          description: >-
            Comma-separated ticker values. Plain tickers (e.g. `AAPL`) match the
            primary stock ticker. Exchange-prefixed values such as `NASDAQ:AAPL`
            are accepted and match by ticker symbol.
          schema:
            type: string
          required: false
        - name: cik
          in: query
          description: >-
            Comma-separated CIK values to filter by. CIKs should include leading
            zeros when applicable, e.g. `0000320193`.
          schema:
            type: string
          required: false
        - name: sector
          in: query
          description: >-
            Comma-separated sectors to filter by, based on US industry
            classification.
          schema:
            type: string
          required: false
        - name: industry
          in: query
          description: >-
            Comma-separated industries to filter by, based on US industry
            classification.
          schema:
            type: string
          required: false
        - name: company_id
          in: query
          description: >-
            Comma-separated internal company IDs to filter by. For US companies,
            this is the full CIK.
          schema:
            type: string
          required: false
        - name: marketcap_category
          in: query
          description: >-
            Comma-separated lowercase market-cap category keys. Client-supported
            inputs are `mega`, `large`, `mid`, `small`, `micro`, and `nano`.
          schema:
            type: string
            pattern: >-
              ^(mega|large|mid|small|micro|nano)(,(mega|large|mid|small|micro|nano))*$
          required: false
        - name: sort
          in: query
          description: >-
            Sort specification as `key:order` pairs, comma-separated. Supported
            keys: `company_name`, `marketcap_category`. Supported orders: `asc`,
            `desc`. Example: `company_name:asc` or
            `marketcap_category:desc,company_name:asc`.
          schema:
            type: string
            pattern: >-
              ^((company_name|marketcap_category):(asc|desc))(,((company_name|marketcap_category):(asc|desc)))*$
          required: false
        - name: page
          in: query
          description: Page number for pagination. Defaults to 1.
          schema:
            type: integer
            minimum: 1
          required: false
        - name: limit
          in: query
          description: >-
            Number of results per page. Defaults to 10000 (returns all
            companies).
          schema:
            type: integer
            minimum: 1
          required: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Company'
                  meta:
                    $ref: '#/components/schemas/Meta'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Company:
      type: object
      description: Represents details of a company
      properties:
        id:
          type: string
          description: Internal Company ID. For US companies, this is the full CIK.
        cik:
          type: string
          nullable: true
          description: SEC Central Index Key
          example: '0000320193'
        company_name:
          type: string
          description: Company name
        company_website:
          type: string
          nullable: true
          description: Company website URL
        ticker:
          type: string
          nullable: true
          description: Primary ticker symbol
        isin:
          type: string
          nullable: true
          description: ISIN code of the company, when available
        marketcap_category:
          type: string
          nullable: true
          description: >-
            Lowercase market-cap category key returned by the API, e.g. `mega`,
            `large`, `mid`, `small`, `micro`, or `nano`
        industry_info:
          $ref: '#/components/schemas/IndustryInfo'
        exchange_info:
          type: array
          description: >-
            Per-exchange identifiers. For US companies this contains entries for
            NYSE, NASDAQ, and/or NYSEMKT. US entries expose `symbol`.
          items:
            type: object
            properties:
              exchange:
                type: string
                enum:
                  - NYSE
                  - NASDAQ
                  - NYSEMKT
                description: Exchange name
              symbol:
                type: string
                nullable: true
                description: Trading symbol on the exchange
              url:
                type: string
                nullable: true
                description: Company page URL on the exchange, when available
    Meta:
      type: object
      properties:
        total_count:
          type: integer
          format: int64
          description: Total item count for the given request.
        page:
          type: integer
          format: int64
          description: Current Page number.
        limit:
          type: integer
          format: int64
          description: Number of items in the current response.
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              status:
                type: string
                description: Error status
              title:
                type: string
                description: Error description
    IndustryInfo:
      type: object
      nullable: true
      description: Industry classification information
      properties:
        macro:
          type: string
          nullable: true
          description: Macro industry classification
        sector:
          type: string
          nullable: true
          description: Sector classification
        industry:
          type: string
          nullable: true
          description: Industry classification
        basic_industry:
          type: string
          nullable: true
          description: Basic industry classification
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````