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

# List billing items (agreement SKUs)

> Every PSA agreement SKU / billed service (ConnectWise, Autotask, Halo) with provider, matchType, matchKey, label, client count, monthly revenue, revenue category and the standards it already proves, highest revenue first (50 per page). Use the exact provider, matchType and matchKey with the sku-links, service plan skus and revenue category endpoints. Staff only; requires read_settings_tool_stack or read_settings_financial_reporting.



## OpenAPI

````yaml /openapi.json get /api/public/v1/standards/settings/sku-catalog
openapi: 3.0.3
info:
  title: MSPortal Public API
  version: 1.0.0
  description: >-
    Public API for MSPortal - provides programmatic access to tenant data.


    ## Authentication


    All endpoints require authentication via API key passed as a Bearer token:


    ```

    Authorization: Bearer <your-api-key>

    ```


    API keys can be created in the MSPortal dashboard under Settings →
    Integrations → API Access.


    **Important:** Do not include cookies in API requests. The public API uses
    stateless authentication only.


    ## Scopes


    API keys are granted specific scopes that determine what operations they can
    perform. Each endpoint documents its required scope(s).


    ## Rate Limiting


    API calls are rate limited per API key. Rate limit information is returned
    in response headers:


    - `X-RateLimit-Limit`: Maximum requests per minute

    - `X-RateLimit-Remaining`: Remaining requests in current window

    - `X-RateLimit-Reset`: When the rate limit resets (ISO 8601)


    ## Request ID


    All responses include an `X-Request-Id` header for debugging and support.
    You can also pass your own `X-Request-Id` header to correlate requests.
  contact:
    name: MSPortal Support
    email: support@msportal.ai
  license:
    name: Proprietary
servers:
  - url: https://app.msportal.ai
    description: Production (US)
  - url: https://eu.msportal.ai
    description: Production (EU)
security:
  - BearerAuth: []
tags:
  - name: Budgets
    description: >-
      Budget management - create, track, and forecast budgets with line items,
      categories, and products
  - name: Calendar
    description: Calendar and meeting management - events, participants, and meeting types
  - name: Companies
    description: Company management endpoints
  - name: Company Users
    description: Company user management - client portal contacts (read-only, paginated)
  - name: Compliance
    description: Compliance check management - runs, assigned checks, and status updates
  - name: Dashboards
    description: Dashboard management - external iframe resources and internal dashboards
  - name: Devices
    description: Device management - inventory, types, and locations
  - name: Goals
    description: Goal management - create, track, and manage goals with tasks and updates
  - name: NPS Surveys
    description: >-
      NPS survey management - Net Promoter Score surveys, responses, and
      analytics
  - name: Reports
    description: >-
      Report management - create, manage, and schedule reports with templates
      and types
  - name: Planner
    description: >-
      Planner item management - tasks, roadmap items, and project planning with
      linked goals, compliance, and projects
  - name: Surveys
    description: >-
      General survey management - multi-question surveys, responses, and
      statistics
  - name: Tickets
    description: Ticket management - view and filter tickets from PSA integrations
  - name: Training
    description: >-
      Training management - courses, enrollments, certificates, and progress
      tracking
  - name: Users
    description: Tenant user management - internal staff and team members (read-only)
  - name: Automation Rules
    description: >-
      Automation rule management - create, configure, and monitor automation
      rules with triggers, conditions, and actions
  - name: Analytics
    description: >-
      Analytics and reporting - company audit data, training analytics, user
      activity, and portfolio metrics
  - name: Client Onboarding
    description: >-
      Client onboarding - portals (phases, tasks, contacts, activation),
      templates, checklist templates, forms and documentation pages
  - name: Backup
    description: >-
      Backup - summaries, protected devices, alerts and SaaS protection (Datto,
      Axcient, Slide, Kaseya)
  - name: Microsoft 365
    description: Microsoft 365 - licenses, users, domains and Secure Score
  - name: Security
    description: >-
      Security - posture summary, EDR incidents, vulnerabilities, email threats,
      firewalls, DNS filtering and security awareness
  - name: Financial
    description: Financial - quotes, invoices and revenue summaries
  - name: Integrations
    description: Integrations - status, sync health, pause and resume (never credentials)
  - name: Documentation
    description: >-
      Documentation - pages, folders and articles synced from Hudu or IT Glue,
      plus built-in pages
  - name: Broadcasts
    description: Broadcasts - emergency broadcasts, recipients and groups
  - name: Notifications
    description: Notifications - the linked user's in-app notifications
  - name: Standards
    description: >-
      Standards - technology standards catalog, service plans, applicability,
      deployment statuses, compliance rollups, white space and costs
  - name: Customer Success
    description: >-
      Customer success - client health scores, trends, benchmarks and Traffic
      Light Reviews
  - name: Tasks
    description: Tasks - the linked user's personal task list
  - name: Tenant Setup
    description: Tenant setup - profile, branding and portal settings (never secrets)
  - name: Roles
    description: Roles - staff and client roles and their permission grants
  - name: Ticket Templates
    description: Ticket templates - reusable ticket definitions
  - name: Readiness
    description: Client readiness - account readiness assessments
  - name: Projects
    description: >-
      Projects - PSA projects with health overlays (deliverables, milestones,
      client actions, weekly updates), phases, tickets, time entries, PSA
      status/owner/priority write-through, ticket notes, task controls, display
      settings and the document library
paths:
  /api/public/v1/standards/settings/sku-catalog:
    get:
      tags:
        - Standards
      summary: List billing items (agreement SKUs)
      description: >-
        Every PSA agreement SKU / billed service (ConnectWise, Autotask, Halo)
        with provider, matchType, matchKey, label, client count, monthly
        revenue, revenue category and the standards it already proves, highest
        revenue first (50 per page). Use the exact provider, matchType and
        matchKey with the sku-links, service plan skus and revenue category
        endpoints. Staff only; requires read_settings_tool_stack or
        read_settings_financial_reporting.
      parameters:
        - schema:
            type: string
            maxLength: 200
            description: Text in the item's label or key
          required: false
          description: Text in the item's label or key
          name: search
          in: query
        - schema:
            type: boolean
            nullable: true
            default: false
            description: Only items billed to at least one client
          required: false
          description: Only items billed to at least one client
          name: onlyBilled
          in: query
        - schema:
            type: boolean
            nullable: true
            default: false
            description: Only items not yet proving any standard
          required: false
          description: Only items not yet proving any standard
          name: unlinkedOnly
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 10000
            default: 1
            description: Page number
          required: false
          description: Page number
          name: page
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            description: Rows per page (max 100)
          required: false
          description: Rows per page (max 100)
          name: limit
          in: query
      responses:
        '200':
          description: Billing items
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/StandardsSkuCatalogEntry'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - data
                  - pagination
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            Forbidden - missing scope (standards.read), the linked user lacks
            the required permission, or the key belongs to a client (company)
            user: standards settings are staff only
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    StandardsSkuCatalogEntry:
      type: object
      properties:
        provider:
          type: string
          enum:
            - connectwise
            - autotask
            - halo
        matchType:
          type: string
          enum:
            - service
            - contract_type
          description: >-
            service: a billed agreement service; contract_type: the agreement
            type the line was billed under
        matchKey:
          type: string
          description: Opaque PSA key, exactly as the catalog returns it
        label:
          type: string
        companyCount:
          type: integer
        monthlyRevenue:
          type: number
        lastBilledOn:
          type: string
          nullable: true
        revenueCategory:
          type: string
          nullable: true
          enum:
            - managed_recurring
            - other_recurring
            - non_recurring
            - null
        provesStandards:
          type: array
          items:
            type: object
            properties:
              itemId:
                type: string
                format: uuid
              name:
                type: string
              matchGroup:
                type: integer
            required:
              - itemId
              - name
              - matchGroup
      required:
        - provider
        - matchType
        - matchKey
        - label
        - companyCount
        - monthlyRevenue
        - lastBilledOn
        - revenueCategory
        - provesStandards
    Pagination:
      type: object
      properties:
        page:
          type: integer
          minimum: 1
          description: Current page number
        limit:
          type: integer
          minimum: 1
          maximum: 100
          description: Items per page
        totalCount:
          type: integer
          description: Total number of items
        totalPages:
          type: integer
          description: Total number of pages
        hasNextPage:
          type: boolean
          description: Whether there is a next page
        hasPrevPage:
          type: boolean
          description: Whether there is a previous page
      required:
        - page
        - limit
        - totalCount
        - totalPages
        - hasNextPage
        - hasPrevPage
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
        requestId:
          type: string
          description: Request correlation ID
        details:
          nullable: true
          description: Additional error details
        code:
          type: string
          description: Error code
      required:
        - error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Use your API key as a Bearer token. API keys can be generated in
        Settings → Integrations → API Access.

````

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