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

# Search companies by name, symbol, ISIN, or FIGI

> Searches companies by name, symbol, ISIN, or FIGI and returns the active securities for each matching organization. Exact matches rank above prefix matches. Within each organization, the primary listing comes first, and US market listings rank ahead of others. The response returns up to 10 results.




## OpenAPI

````yaml /api-reference/openapi-v2.json post /helper/companies/search
openapi: 3.0.0
info:
  title: Noonum API v2
  version: 2.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create and manage investment strategies, portfolios, and backtests. The API
    covers the full strategy lifecycle, including creation and editing, the
    archive and revive flow, version submission and run state, result companies,
    evidence, factsheets, exposures, and taxonomy.
servers:
  - url: https://api.noonum.ai/v2
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and manage your own investment strategies.
  - name: Helper
    description: >-
      Shared utilities for company lookup and search, objective tooling, and a
      health check.
  - name: Portfolios
    description: Create, read, update, and delete portfolios.
  - name: Backtest
    description: Run a standalone backtest on a portfolio of companies.
paths:
  /helper/companies/search:
    post:
      tags:
        - Helper
      summary: Search companies by name, symbol, ISIN, or FIGI
      description: >
        Searches companies by name, symbol, ISIN, or FIGI and returns the active
        securities for each matching organization. Exact matches rank above
        prefix matches. Within each organization, the primary listing comes
        first, and US market listings rank ahead of others. The response returns
        up to 10 results.
      operationId: app.api.v2.helper.company_search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  example: GO
                  description: Partial or full company name, ticker, ISIN, or FIGI.
                limit:
                  type: integer
                  format: int32
                  minimum: 1
                  default: 10
                  description: Maximum number of results to return.
              required:
                - query
      responses:
        '200':
          description: The matching companies.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          example: c3b1862e-0c7a-4a0d-b88e-4bc499892f00
                        name:
                          type: string
                          example: Alphabet Inc.
                        market_cap:
                          type: number
                          nullable: true
                          example: 1500000000
                        sector:
                          type: string
                          nullable: true
                          example: Information Technology
                        industry:
                          type: string
                          nullable: true
                          example: Systems Software
                        securities:
                          type: array
                          items:
                            type: object
                            properties:
                              symbol:
                                type: string
                                nullable: true
                                example: GOOG
                              isin:
                                type: string
                                nullable: true
                                example: US02079K3059
                              figi:
                                type: string
                                nullable: true
                                example: BBG009S39JX6
                              market:
                                type: string
                                nullable: true
                                example: US
                              exchange:
                                type: string
                                nullable: true
                                example: NASDAQ
                              is_primary:
                                description: >-
                                  Whether this is the organization's primary
                                  listing.
                                type: boolean
                                example: true
                            required:
                              - is_primary
                      required:
                        - id
                        - name
                        - securities
                required:
                  - results
        '400':
          description: The query is missing or invalid.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Field 'query' is required and must be a non-empty string.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: |
        Enter 'Bearer' followed by a space and then your JWT or API Key.
        Example: `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`
        or `Bearer YOUR_API_KEY_HERE`

````