Sign in
Listings

Convert listing to sale

Converts an active listing to a sale transaction. The listing must be in Active status (not expired, archived, or already converted). Creates a new sale linked to the listing, copies contacts, shared contacts, and commission tiers from the listing. The listing status is updated to Transaction (converted). saleChecklistTypeId is required and must belong to the listing's office. Optional fields default to listing data: salePrice defaults to listingPrice, mlsNumber defaults to listing's MLS number, sourceId defaults to listing's source.

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.

Integration Requirement

  • Retrieve the corresponding ...Form endpoint immediately before write operations to get current dynamic required fields and allowed values.
post/api/files/listings/{listingGuid}/convert-to-sale

Path parameters

listingGuidstring guid required

GUID of the listing to convert.

Request body

saleChecklistTypeIdinteger

The checklist type ID for the new sale. Must belong to the listing's office.

contractAcceptanceDatestring date-time nullable

Contract acceptance date for the sale. Optional; if not provided, it remains unset.

salePricenumber nullable

Sale price. Defaults to listing price if not provided.

escrowNumberstring nullable

Escrow/closing number.

escrowClosingDatestring date-time nullable

Escrow closing date.

actualClosingDatestring date-time nullable

Actual closing date.

sourceIdinteger nullable

SourceId can be retrieved from the AllowableSelections list.

otherSourcestring nullable

Required only for certain SourceId fields.

mlsNumberstring nullable

MLS number. Defaults to listing's MLS number if not provided.

isOfficeLeadboolean nullable
fileIdstring nullable
apnstring nullable

Response

warningsstring[] nullable