---
title: "Update tiered commissions (V2)"
method: PUT
path: "/api/v2/files/listings/{listingGuid}/tieredCommissions"
tags: ["V2 Listing Tiered Commissions"]
---

# Update tiered commissions (V2)

`PUT /api/v2/files/listings/{listingGuid}/tieredCommissions`

Replaces the tiered commission tiers for a listing. Tiered and flat commissions are mutually exclusive.

### Validation & Requirements
#### Required Parameters
- `listingGuid` (path, string, format=guid)
- `tieredCommissions` (body, object)

#### Required JSON Body Fields
- None

#### Validations
- Invalid GUID values in `*Guid`/`*Guids` fields return `422 Unprocessable Entity`.
- Invalid date values in `*date*` fields return `422 Unprocessable Entity`.
- Missing required request body returns `422 Unprocessable Entity` with `Missing request body.`.
- Additional business-rule validation may return `422` with details in the `errors` array.

## Path parameters

- `listingGuid` string, guid, required

## Request body

- TwoTieredCommissionPayloadDto
  - `listingCommission` TwoTieredCommissionDto
    - `firstTier` CommissionTierDto
      - `percentAmount` number, nullable
      - `dollarAmount` number, nullable
      - `additionalDollarAmount` number, nullable
    - `secondTier` CommissionTierDto
      - `percentAmount` number, nullable
      - `dollarAmount` number, nullable
      - `additionalDollarAmount` number, nullable
    - `createdOn` string, date-time
  - `salesCommission` TwoTieredCommissionDto
    - `firstTier` CommissionTierDto
      - `percentAmount` number, nullable
      - `dollarAmount` number, nullable
      - `additionalDollarAmount` number, nullable
    - `secondTier` CommissionTierDto
      - `percentAmount` number, nullable
      - `dollarAmount` number, nullable
      - `additionalDollarAmount` number, nullable
    - `createdOn` string, date-time
  - `officeGrossCommission` number, nullable

## Response `200`

- LinkedResponseOfResult3
  - `value` Result3
    - `listingGuid` string, guid
    - `isTieredCommission` boolean
    - `commissions` TwoTieredCommissionPayloadDto
      - `listingCommission` TwoTieredCommissionDto
        - `firstTier` CommissionTierDto
          - `percentAmount` number, nullable
          - `dollarAmount` number, nullable
          - `additionalDollarAmount` number, nullable
        - `secondTier` CommissionTierDto
          - `percentAmount` number, nullable
          - `dollarAmount` number, nullable
          - `additionalDollarAmount` number, nullable
        - `createdOn` string, date-time
      - `salesCommission` TwoTieredCommissionDto
        - `firstTier` CommissionTierDto
          - `percentAmount` number, nullable
          - `dollarAmount` number, nullable
          - `additionalDollarAmount` number, nullable
        - `secondTier` CommissionTierDto
          - `percentAmount` number, nullable
          - `dollarAmount` number, nullable
          - `additionalDollarAmount` number, nullable
        - `createdOn` string, date-time
      - `officeGrossCommission` number, nullable
  - `warnings` string[], nullable
  - `links` Link[], nullable
    - `href` string, nullable
    - `rel` string, nullable
    - `method` string, nullable

## Other responses

- `404`
- `422`

---

[API](https://skmtc.net/skyslope/apis/skyslope-api.md) · [All operations](https://skmtc.net/skyslope/apis/skyslope-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyslope/skyslope-api/revisions/bad0d2db9b7a/schema)