Sign in
latestOpenAPI 3.0.02026-08-12207455917.9 KB

bad0d2db9b7a

V2 Sale Commissions

Update commissions (V2)

Updates commissions for the specified sale, using V2 managed fields.

Validation & Requirements

Required Parameters

  • saleGuid (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/sales/{saleGuid}/commissions

Path parameters

saleGuidstring guid required

GUID of the sale whose commissions you want to update.

Request body

transactionCoordinatorNamestring nullable

Deprecated. Use the /transactionCoordinators endpoint for Transaction Coordinator names.

transactionCoordinatorFeenumber nullable

Deprecated. Use AdminBrokerageComp instead.

adminBrokerageCompnumber nullable

Admin brokerage compensation fee. Preferred over TransactionCoordinatorFee.

dateOfCheckstring date-time nullable
datePostedToLogBookstring date-time nullable
listingCommissionPercentnumber nullable

If required, either percent or amount field needs to be filled

listingCommissionAmountnumber nullable

If required, either percent or amount field needs to be filled

saleCommissionPercentnumber nullable

If required, either percent or amount field needs to be filled

saleCommissionAmountnumber nullable

If required, either percent or amount field needs to be filled

otherDeductionsnumber nullable
personalDealboolean
commissionBreakdownDetailsstring nullable

Response

valueUpdateSaleCommissionsResponse
warningsstring[] nullable