---
title: "Update commission referral"
method: PATCH
path: "/api/files/listings/{listingGuid}/commissionReferral"
tags: ["Listing Commission Referral"]
---

# Update commission referral

`PATCH /api/files/listings/{listingGuid}/commissionReferral`

Patches existing listing commission referral fields. Set contact to null to remove the contact. Returns 422 if referral data does not exist, percent and amount are both set, values are out of range (percent 0-100; amount >= 0), brokerName exceeds 50 characters, or contact fields are invalid.

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

#### 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 referral values must satisfy domain commission rules; invalid percentages/amounts return 422.

#### Integration Requirement
- Retrieve the corresponding `...Form` endpoint immediately before write operations to get current dynamic required fields and allowed values.

## Path parameters

- `listingGuid` string, guid, required

## Query parameters

- `Contact.FirstName` string, nullable
- `Contact.LastName` string, nullable
- `Contact.Email` string, nullable
- `Contact.PhoneNumber` string, nullable
- `BrokerName` string, nullable
- `Amount` number, nullable
- `Percent` number, nullable

## Response `200`

- LinkedResponseOfAddCommissionReferralToListing
  - `value` AddCommissionReferralToListing
    - `subscriberGuid` string, guid
    - `userGuid` string, guid
    - `listingGuid` string, guid
    - `form` AddCommissionReferralToListingForm
      - `contact` CommissionReferralContactForm
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `email` string, nullable
        - `phoneNumber` string, nullable
      - `brokerName` string, nullable
      - `amount` number, nullable
      - `percent` 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)