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

# List the companies most similar to a company

> Ranks companies by the segments they share with this one, weighing how material each shared segment is to both companies and the size of the company, so a small company sharing one segment does not outrank a large peer. Companies tied with the last one kept are included. Each company names the segments it shares, at its own rating. You must be subscribed to the company, not to the companies returned.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /segments/companies/{companyId}/similar
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.
  - name: Segments
    description: >-
      Companies' business segments, grouped into segment groups and tagged to
      GICS, NAICS and ICB industries, and the companies most similar to a
      company by the segments they share. You read a company's segment data once
      you subscribe to the company. A subscription lasts 365 days and cannot be
      cancelled or moved to another company; your plan sets how many you can
      hold at once, and `GET /segments/subscriptions` lists them.
  - name: Usage
    description: Read your plan, your remaining credits, and your credit usage.
paths:
  /segments/companies/{companyId}/similar:
    parameters:
      - name: companyId
        in: path
        required: true
        schema:
          type: string
          format: uuid
        description: Company (issuer) ID in the Noonum database.
    get:
      tags:
        - Segments
      summary: List the companies most similar to a company
      description: >-
        Ranks companies by the segments they share with this one, weighing how
        material each shared segment is to both companies and the size of the
        company, so a small company sharing one segment does not outrank a large
        peer. Companies tied with the last one kept are included. Each company
        names the segments it shares, at its own rating. You must be subscribed
        to the company, not to the companies returned.
      operationId: app.api.v2.segments.similar
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          description: Number of companies to keep before ties.
      responses:
        '200':
          description: The similar companies, most similar first.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - name
                        - symbol
                        - score
                        - sharedSegments
                      properties:
                        id:
                          type: string
                          format: uuid
                        name:
                          type: string
                          nullable: true
                        symbol:
                          type: string
                          nullable: true
                        score:
                          type: number
                        sharedSegments:
                          description: >-
                            The segments both companies have, at this company's
                            rating: most material first, then by name.
                          type: array
                          items:
                            type: object
                            required:
                              - id
                              - name
                              - materiality
                            properties:
                              id:
                                type: integer
                              name:
                                type: string
                              materiality:
                                type: string
                                description: >-
                                  How material a segment is to the company:
                                  `core` (a main business), `significant`, or
                                  `minor`.
                                enum:
                                  - core
                                  - significant
                                  - minor
        '400':
          description: The `companyId` is not a valid UUID.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    description: A human-readable description of the error.
                    type: string
        '403':
          description: >-
            Your plan does not include segment data, or you are not subscribed
            to the company.
          content:
            application/json:
              schema:
                type: object
                description: >-
                  Returned when your plan does not include segment data, or when
                  you are not subscribed to a company of the request.
                required:
                  - error
                properties:
                  error:
                    type: string
                  companyIds:
                    description: The companies of the request you are not subscribed to.
                    type: array
                    items:
                      type: string
                      format: uuid
        '404':
          description: The company was not found.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    description: A human-readable description of the error.
                    type: string
        '409':
          description: This login's email already belongs to another Noonum account.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    description: A human-readable description of the error.
                    type: 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`

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.