---
title: "Get Provider Commission Structures"
method: GET
path: "/inventory/providers/{provider_id}/commission-groups"
tags: ["provider", "inventory"]
---

# Get Provider Commission Structures

`GET /inventory/providers/{provider_id}/commission-groups`

## Request

- Base URL: `https://docs.decodahealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.decodahealth.com/inventory/providers/{provider_id}/commission-groups`
- Auth: none declared. Required headers: `TENANT`, `API-KEY`
- TypeScript: <https://skmtc.dev/decodahealth/apis/decoda-api/docs/inventory/providers/:provider_id/commission-groups/get.ts> (a function with typed inputs; its response is checked against the schema)

Get all commission groups assigned to a provider

## Path parameters

- `provider_id` string, required

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Response `200`

Successful Response

- CommissionStructureDetailOutput[]
  - `id` string: Unique identifier for the commission group
  - `name` string, required: Name of the commission group
  - `description` string, nullable: Optional description of the commission group
  - `commissions` CommissionDetailOutput[], nullable: Commissions in this group
    - `id` string: Unique identifier for the commission
    - `itemId` string, nullable: Optional item this commission applies to (includes services and packages)
    - `itemCategory` string, nullable: Optional category name this commission applies to (references category.name)
    - `itemIsPhysical` boolean, nullable: Optional filter by whether item is physical
    - `totalSalesAmount` integer, nullable: Optional minimum total sales amount threshold in cents
    - `commissionStructureId` string, required: Commission structure this commission belongs to
    - `percentage` number, nullable: Commission percentage (0.0 to 1.0)
    - `amount` integer, nullable: Fixed commission amount in cents
    - `deductCost` boolean: Whether to deduct item cost before calculating commission (services only)
    - `isArchived` boolean: Whether the commission is archived
    - `updatedDate` string, date-time, nullable: When the commission was last updated
    - `createdDate` string, date-time, nullable: When the commission was created
    - `item` ItemTiny
      - `id` string: Unique identifier for the item
      - `name` string, required: Name of the item
      - `brandName` string, nullable: Optional brand name of the item
      - `description` string, nullable: Optional description of the item
      - `price` integer, required: Price of the item in cents
      - `category` string, nullable: Category name (references category.name)
      - `unit` 'AMPOULES' | 'APPLICATORS' | 'BOTTLES' | 'BOXES' | 'CAPSULES' | 'CUPS' | 'DOSES' | 'G_PER_ML' | 'GRAMS' | 'IU' | 'IU_PER_ML' | 'OUNCES' | 'FLUID_OUNCES' | 'KG' | 'KITS' | 'LITERS' | 'MCG' | 'MG' | 'MG_PER_ML' | 'ML' | 'MMOL' | 'MICROGRAM_PER_ML' | 'PACKS' | 'PAIRS' | 'PATCHES' | 'PERCENTAGE' | 'PIECES' | 'POUCHES' | 'ROLLS' | 'SACHETS' | 'SHEETS' | 'SPRAYS' | 'STRIPS' | 'SYRINGES' | 'TABLETS' | 'TABLETS_PER_DAY' | 'TESTS' | 'TUBES' | 'UNITS' | 'VIALS' | 'TREATMENTS' | 'SESSIONS' | 'PULSES' | 'JOULES' | 'CENTIMETERS' | 'THREAD_COUNT' | 'INJECTIONS' | 'WRINKLE_UNITS' | 'POUNDS' | 'FEET' | 'INCHES'
      - `isPhysical` boolean: Whether the item is physical
      - `isArchived` boolean: Whether the item is archived
      - `internalNotes` string, nullable: Optional internal notes for the item
      - `taxable` boolean: Whether the item is subject to taxes
      - `sortOrder` integer, nullable: Optional sort order for the item
      - `allowCustomPricing` boolean: Whether custom pricing is allowed for this item
      - `type` 'ITEM' | 'PRODUCT' | 'MEDICATION' | 'SERVICE' | 'PACKAGE' | 'MEMBERSHIP'
  - `providers` ProviderTiny[], nullable: Providers in this group
    - `id` string, required
    - `firstName` string, required
    - `lastName` string, nullable
    - `email` string, nullable
    - `createdDate` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) - [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) - [OpenAPI document](https://skmtc.dev/decodahealth/apis/decoda-api/revisions/4ab18c80f9e9?raw)
