V2 Listing Commissions

Update commissions (V2)

Updates listing commission data using V2 managed fields and subscriber managed-field rules.

Validation & Requirements

Required Parameters

  • listingGuid (path, string, format=guid)
  • form (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.
  • Commission percentages must be between 0 and 100, and commission amounts cannot be negative.
  • Each commission entry must be percent or amount, not both.
put/api/v2/files/listings/{listingGuid}/commissions

Request

  • Base URL
    https://api.skyslope.com
  • URL
    https://api.skyslope.com/api/v2/files/listings/{listingGuid}/commissions
  • Auth
    OpenID Connect (https://example.com/.well-known/openid-configuration)

Path parameters

listingGuidstring guid required

GUID of the listing you want to update.

Request body

listingCommissionPercentnumber nullable
listingCommissionAmountnumber nullable
saleCommissionPercentnumber nullable
salesCommissionAmountnumber nullable
commissionBreakdownstring nullable
referralAmountnumber nullable
referralAmountPercentnumber nullable
transCoordinatorFeenumber nullable

Deprecated. Use AdminBrokerageComp instead.

adminBrokerageCompnumber nullable

Admin brokerage compensation fee. Preferred over TransCoordinatorFee.

officeGrossCommissionnumber nullable

Response

warningsstring[] nullable

Changes

No recorded changes to this operation across all 6 revisions of this API.