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

# Get Taxonomy Tree

> Returns the complete taxonomy hierarchy in a nested tree structure for efficient partner caching with enhanced filtering options.



## OpenAPI

````yaml /openapi.json get /api/v2/categories/tree
openapi: 3.1.0
info:
  title: Legitmark Partner API
  description: Comprehensive partner integration API for Legitmark authentication platform
  version: 2.0.0
  contact:
    name: Legitmark Support
    email: support@legitmark.com
    url: https://legitmark.com
servers:
  - url: https://api.legitmark.com
    description: Production API
security:
  - BearerAuth: []
tags:
  - name: Service Requests
    description: Create, retrieve, and manage authentication service requests.
  - name: Media Management
    description: Upload images for service request authentication.
  - name: Taxonomy
    description: Browse categories, types, brands, models, and services to build requests.
paths:
  /api/v2/categories/tree:
    get:
      tags:
        - Taxonomy
      summary: Get Taxonomy Tree
      description: >-
        Returns the complete taxonomy hierarchy in a nested tree structure for
        efficient partner caching with enhanced filtering options.
      parameters:
        - name: activeOnly
          in: query
          description: Filter to only active items
          schema:
            type: boolean
            default: false
        - name: includeCounts
          in: query
          description: Include item counts for each taxonomy level
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Category tree retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Catalog tree fetched successfully
                  category:
                    type: string
                    enum:
                      - SUCCESS
                    example: SUCCESS
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          format: uuid
                        name:
                          type: string
                        types:
                          type: array
                          items:
                            type: object
                            properties:
                              uuid:
                                type: string
                                format: uuid
                              name:
                                type: string
                              brands:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    uuid:
                                      type: string
                                      format: uuid
                                    name:
                                      type: string
                                    models:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          uuid:
                                            type: string
                                            format: uuid
                                          name:
                                            type: string
                  required:
                    - message
                    - category
                    - data
              example:
                message: Catalog tree fetched successfully
                category: SUCCESS
                data:
                  - uuid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    name: Bags
                    types:
                      - uuid: c3d4e5f6-a7b8-9012-cdef-345678901234
                        name: Tote Bags
                        brands:
                          - uuid: e5f6a7b8-c9d0-1234-efab-567890123456
                            name: Louis Vuitton
                            models:
                              - uuid: f6a7b8c9-d0e1-2345-fabc-678901234567
                                name: Neverfull MM
                              - uuid: a7b8c9d0-e1f2-3456-abcd-789012345678
                                name: Neverfull GM
                  - uuid: b2c3d4e5-f6a7-8901-bcde-f12345678901
                    name: Watches
                    types:
                      - uuid: d4e5f6a7-b8c9-0123-defa-456789012345
                        name: Luxury Watches
                        brands:
                          - uuid: b8c9d0e1-f2a3-4567-bcde-890123456789
                            name: Rolex
                            models:
                              - uuid: c9d0e1f2-a3b4-5678-cdef-901234567890
                                name: Submariner
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Bearer token authentication. Use your API key in the format: Bearer
        leo_xxxxxxxx
      x-default: leo_your_api_key_here

````