> ## 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.json post /helper/companies/lookup
openapi: 3.0.0
info:
  title: Noonum API
  version: 1.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create, read, update, and delete your own investment strategies, browse
    public premade strategies, run semantic search, and call supporting utility
    endpoints.
servers:
  - url: https://api.noonum.ai/v1
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and delete your own investment strategies.
  - name: PremadeStrategies
    description: Read public premade strategies and find the ones closest to an objective.
  - name: Helper
    description: >-
      Supporting endpoints for company lookup, objective editing, and health
      checks.
  - name: Benchmarks
    description: Read benchmark data.
  - name: Portfolios
    description: Create, read, update, and delete your portfolios.
  - name: Backtest
    description: Backtest a portfolio without saving it.
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.v1.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`

````