Comp
A comp: one market transaction your organisation knows of — a closed project of your own, or a deal your team recorded — anchored on one property with its facts as of the deal. Visible to your whole organisation; part of the Professional plan.
- completedType: boolean
Is Planned requiredThe completion date is planned, not yet reached.
- createdType: stringFormat: date-time
Utc requiredWhen the deal was recorded.
- createdType: enum
Via requiredThrough which surface the deal was recorded: the app, this API, an agent, or Propstreet itself.
valuesappapiagentsystem - dealType: stringFormat: date
Date requiredThe one date the deal is filed under: completion unless only planned, else signing, else the planned completion.
- etagType: stringrequired
The deal's version; send it as
If-Matchon a write. - hiddenType: booleanrequired
Hidden from the list for the whole organisation: always in the change feed, in a search only with
includeHidden, never in the summary. - idType: stringrequired
Unique deal identifier.
- kindenumconst:salerequired
What kind of deal this is; only
saletoday.valuessale - locationType: enum
Precision requiredaddress, orareawhen the deal shows only its area (its address is not public).valuesaddressarea - missingType: enumrequired
What the deal lacks to be complete; empty when nothing is missing.
- partiesType:requiredProperties: 9
The seller, buyer and advisors — companies or people in your network, or your own organisation.
- priceType: boolean
Approximate requiredThe price is approximate ("around 180").
- priceType: boolean
Unknown requiredThe price is known to be unknown, as opposed to not yet recorded.
- sourceType: enum
Channels requiredEvery source channel the deal counts under in the source filter.
- sourcesType:requiredProperties: 16
Where your team learned about the deal. Your own project is not a source; it is
project. - updatedType: stringFormat: date-time
Utc requiredWhen the deal, its parties, sources, property or notes last changed.
- yieldType: boolean
Approximate requiredThe yield is approximate.
- categoryType: null | string
The property's primary type, the same vocabulary as the property endpoints' categories.
- completedType: null | stringFormat: date
On When the deal completed, or is planned to complete when
completedIsPlannedis true. - createdType: nullable
By Properties: 2Who recorded the deal, when known.
- deletedType: null | stringFormat: date-time
Utc When the deal was deleted or voided; null while it holds.
- hiddenType: null | stringFormat: date-time
Utc When the deal was hidden.
- nameType: null | string
The deal's name: its own, else the property's.
- priceType: nullableProperties: 3
The agreed price in full currency units (
scaleis alwaysnone); null when unknown. - priceType: enumnullable
Certainty How sure your organisation is about the price.
valuesconfirmedreportedestimated - priceType: null | number | stringFormat: double
Per Sqm Price divided by leasable area, in the price's currency per square metre; never for land, an unknown price or a missing area.
- projectType: nullableProperties: 4
Your own project behind the deal, when it came from a closed project. A project the caller may not open comes back with
accessiblefalse and no id or name. - propertyType: nullableProperties: 21
The one property the deal is about, with its facts as of the deal; null only for a closed project without a property.
- removalType: enumnullable
Reason Why the deal no longer holds; set only on deleted rows in the change feed.
valuesdeletedvoided - signedType: null | stringFormat: date
On When the deal was signed.
- streetType: null | string
Address The deal's street address; null when nobody gave one (
missingthen namesaddress). WhenlocationPrecisionisareathe deal shows only its area. - typeType: null | string
The primary type with its sub-type, as the property endpoints spell it (for example
industrial/warehouse). - uriType: null | string
Opaque Propstreet deep link (
propstreet://comp/{id}); app metadata, not a website URL. - voidedType: null | stringFormat: date-time
Utc When the project behind the deal was corrected to no sale; the deal then counts as deleted.
- yieldType: null | number | stringFormat: double
The yield in percent (5.0 = 5%); never set for land.
- yieldType: enumnullable
Certainty How sure your organisation is about the yield.
valuesconfirmedreportedestimated