> ## 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.

# Look up companies by identifier

> Looks up Noonum companies by ISIN or ticker symbol. The request body
must include at least one identifier.




## OpenAPI

````yaml /api-reference/openapi-v2.json post /helper/companies/lookup
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/lookup:
    post:
      tags:
        - Helper
      summary: Look up companies by identifier
      description: |
        Looks up Noonum companies by ISIN or ticker symbol. The request body
        must include at least one identifier.
      operationId: app.api.v2.helper.retrieve_companies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  example: c3b1862e-0c7a-4a0d-b88e-4bc499892f00
                  description: Unique company (issuer) identifier.
                isin:
                  type: string
                  example: US0378331005
                  description: International Securities Identification Number.
                symbol:
                  type: string
                  example: AAPL
                  description: Ticker symbol.
              description: >-
                Provide at least one of `id`, `isin`, or `symbol`. When you
                provide more than one, all must match.
      responses:
        '200':
          description: The matching companies.
          content:
            application/json:
              schema:
                type: object
                properties:
                  companies:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: c3b1862e-0c7a-4a0d-b88e-4bc499892f00
                        name:
                          type: string
                          example: Apple Inc.
                        sector:
                          type: string
                          nullable: true
                          example: Technology
                        industry:
                          type: string
                          nullable: true
                          example: Consumer Electronics
                        marketCap:
                          type: number
                          format: float
                          nullable: true
                          example: 3000000000000
                        securities:
                          type: array
                          items:
                            type: object
                            properties:
                              symbol:
                                type: string
                                nullable: true
                                example: AAPL
                              isin:
                                type: string
                                nullable: true
                                example: US0378331005
                      required:
                        - id
                        - name
                        - securities
                required:
                  - companies
        '400':
          description: No identifier was provided, or the input is invalid.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Either 'isin' or 'symbol' is required.
        '404':
          description: No companies matched the identifiers.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: No companies found for the provided identifiers.
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`

````