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

# List asset categories (cursor-paginated).

> Requires the inventory:read scope.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/inventory/categories
openapi: 3.0.1
info:
  title: Secfix Public API
  description: >-
    Machine-to-machine API for the Secfix compliance platform. Authenticate with
    the OAuth 2.0 client_credentials grant via POST /oauth/token, then call /v1
    endpoints with the bearer access token. Errors follow RFC 7807
    (application/problem+json) with stable code strings; lists use opaque cursor
    pagination.
  contact:
    name: Secfix Support
    url: https://secfix.com
    email: support@secfix.com
  license:
    name: Proprietary
    url: https://secfix.com/license
  version: 1.0.0
servers:
  - url: https://api.secfix.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Health
    description: Service liveness.
  - name: Inventory
    description: List and govern assets across all categories.
  - name: OAuth
    description: Token endpoint for OAuth 2.0 client-credentials authentication.
  - name: Computers
    description: Read-only monitored computers with device compliance posture.
paths:
  /v1/inventory/categories:
    get:
      tags:
        - Inventory
      summary: List asset categories (cursor-paginated).
      description: Requires the inventory:read scope.
      operationId: list
      parameters:
        - name: pageSize
          in: query
          required: false
          schema:
            type: integer
            format: int32
        - name: pageCursor
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CursorPageAssetCategoryDto'
components:
  schemas:
    CursorPageAssetCategoryDto:
      type: object
      properties:
        pageInfo:
          $ref: '#/components/schemas/PageInfo'
        results:
          type: array
          description: The page of results.
          items:
            $ref: '#/components/schemas/AssetCategoryDto'
      description: Standard cursor-paginated list envelope.
    PageInfo:
      type: object
      properties:
        endCursor:
          type: string
          description: >-
            Opaque cursor for the next page (pass as pageCursor). Null when
            there are no more results.
          example: eyJjIjoiMjAyNi0wNi0zMFQwMjowMDowMFoiLCJyIjoiM2YxYzlhMmUifQ..
        hasNextPage:
          type: boolean
          description: Whether more results are available after this page.
          example: true
        totalCount:
          type: integer
          description: >-
            Total number of results matching the request across all pages (not
            just this page).
          format: int64
          example: 137
      description: Cursor-pagination metadata.
    AssetCategoryDto:
      type: object
      properties:
        displayLabel:
          type: string
          description: Human-readable category label.
          example: Cloud
        key:
          type: string
          description: Stable asset category key.
          example: CLOUD
      description: Asset category. key is the stable category identifier.
  securitySchemes:
    bearerAuth:
      type: http
      description: Bearer access token obtained from /oauth/token.
      scheme: bearer
      bearerFormat: JWT

````