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

# Browse segment groups by industry taxonomy

> Returns every industry of the taxonomy, including industries with no segment group, with the segment groups tagged to each. `sectors` are the taxonomy's top level and `industries` the level segment groups are tagged at (GICS industry, NAICS subsector, ICB subsector); each industry's `path` names the levels in between. Your plan must include segment data; a group's `segmentNames` are returned only when it also has taxonomy access.



## OpenAPI

````yaml /api-reference/openapi-v2.json get /segments/taxonomy/{taxonomy}
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/taxonomy/{taxonomy}:
    parameters:
      - name: taxonomy
        in: path
        required: true
        schema:
          type: string
          enum:
            - gics
            - naics
            - icb
        description: The industry taxonomy to build the tree from.
    get:
      tags:
        - Segments
      summary: Browse segment groups by industry taxonomy
      description: >-
        Returns every industry of the taxonomy, including industries with no
        segment group, with the segment groups tagged to each. `sectors` are the
        taxonomy's top level and `industries` the level segment groups are
        tagged at (GICS industry, NAICS subsector, ICB subsector); each
        industry's `path` names the levels in between. Your plan must include
        segment data; a group's `segmentNames` are returned only when it also
        has taxonomy access.
      operationId: app.api.v2.segments.taxonomy
      responses:
        '200':
          description: The taxonomy tree down to segment groups.
          content:
            application/json:
              schema:
                type: object
                required:
                  - sectors
                properties:
                  sectors:
                    type: array
                    items:
                      type: object
                      required:
                        - name
                        - industries
                      properties:
                        name:
                          type: string
                        industries:
                          type: array
                          items:
                            type: object
                            required:
                              - industry
                              - path
                              - codes
                              - segmentGroups
                            properties:
                              industry:
                                type: string
                              path:
                                type: array
                                items:
                                  type: string
                              codes:
                                type: array
                                items:
                                  type: string
                              segmentGroups:
                                type: array
                                items:
                                  type: object
                                  required:
                                    - id
                                    - name
                                    - nSegments
                                    - nCompanies
                                  properties:
                                    id:
                                      type: integer
                                    name:
                                      type: string
                                    nSegments:
                                      type: integer
                                    nCompanies:
                                      description: Companies with a segment of the group.
                                      type: integer
                                    segmentNames:
                                      description: >-
                                        The names of the group's segments,
                                        alphabetical. Only when your plan has
                                        taxonomy access.
                                      type: array
                                      items:
                                        type: string
        '403':
          description: Your plan does not include segment data.
          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.