Create Valuation
HTTP Request
POSThttps://staging.api-gw.propdata.net/listings/api/v1/valuations/
Example Response
{"id": 0,"site": 0,"lightstone": 0,"lightstone_id": 0,"lightstone_data": null,"residential": "string","commercial": "string","owner": 0,"created": "2025-08-03T14:46:39.081Z","modified": "2025-08-03T14:46:39.081Z","deleted": "2025-08-03T14:46:39.081Z","uuid": "770bba28-9f80-4d40-9c51-6e022364af91","source_ref": "string","template": "string","branch": -2147483648,"agent": -2147483648,"approving_agent": -2147483648,"status": "string","model": "string","location": -2147483648,"comments": "string","valuation_extras": null,"created_by": -2147483648,"updated_by": -2147483648}
Name | Description |
---|---|
id | integer ID |
tags nullable | array of strings Choices: [ 1,2,3...2147483648 ] |
site | integer Site |
on_show_events | array Choices: [ 1,2,3...2147483648 ] |
portals | array Choices: [ 1,2,3...2147483648 ] |
area | integer Area |
meta | string Meta |
description | stringnon-empty Description |
translated_descriptions nullable | array Choices: [ 1,2,3...2147483648 ] |
availability | array of integers Choices: [ 1,2,3...2147483648 ] |
generic | string Generic |
valuation nullable | integer Valuation |
web_ref nullable | string Web ref |
model | stringnon-empty Model |
distance | stringnon-empty Distance |
created | string Created |
modified | string Modified |
deleted nullable | string Deleted |
uuid | string Uuid |
source_ref nullable | string<= 100 characters Source ref |
branch required | integer Branch - The Branch ID this listing is assigned to |
agent required | integer Agent - The agent ID of the primary listing agent |
agent_2 nullable | integer Agent 2 - The agent ID of the second listing agent |
agent_3 nullable | integer Agent 3 - The agent ID of the third listing agent |
agent_4 nullable | integer Agent 4 - The agent ID of the fourth listing agent |
poa | boolean Poa - Whether the listing price is available on request |
owner_viewing_arrangements nullable | string Owner viewing arrangements |
location required | integer Location |
is_custom_location | boolean Is custom location |
unit_number nullable | string<= 10 characters Unit number |
street_number nullable | string<= 10 characters Street number |
street_name nullable | string<= 100 characters Street name |
mapping_option nullable | string Mapping optionChoices: AddressSuburb |
complex_name nullable | string<= 60 characters Complex name |
publish_street_address | boolean Publish street address |
marketing_heading nullable | string<= 100 characters Marketing heading |
map_image nullable | integer Map image |
map_x_position nullable | string<= 50 characters Map x position |
map_y_position nullable | string<= 50 characters Map y position |
suburb_map_image nullable | integer Suburb map image |
suburb_x_position nullable | string<= 50 characters Suburb x position |
suburb_y_position nullable | string<= 50 characters Suburb y position |
team nullable | integer Team |
display_on_website | boolean Display on website |
display_on_branch | boolean Display on branch |
display_on_team | boolean Display on team |
display_on_agent | boolean Display on agent |
display_on_agent_2 | boolean Display on agent 2 |
display_on_agent_3 | boolean Display on agent 3 |
display_on_agent_4 | boolean Display on agent 4 |
feature_on_newsletter | boolean Feature on newsletter |
feature_on_agent_newsletter | boolean Feature on agent newsletter |
featured | boolean Featured |
header_images nullable | array of integers Header imagesChoices: [ 1,2,3...2147483648 ] |
listing_images nullable | array of integers Listing imagesChoices: [ 1,2,3...2147483648 ] |
floor_plans nullable | array of integers Floor plansChoices: [ 1,2,3...2147483648 ] |
documents nullable | array of integers DocumentsChoices: [ 1,2,3...2147483648 ] |
private_documents nullable | array of integers Private documentsChoices: [ 1,2,3...2147483648 ] |
on_show | boolean On show |
on_show_directions nullable | string On show directions |
on_show_every_saturday | boolean On show every saturday |
on_show_every_sunday | boolean On show every sunday |
on_show_start_time nullable | string On show start time |
on_show_end_time nullable | string On show end time |
video_streaming_platform | string Video streaming platformChoices: YouTubeVimeo |
video_id nullable | string<= 150 characters Video id |
brochure nullable | integer Brochure |
override_availability | boolean Override availability |
owners nullable | array of integers OwnersChoices: [ 1,2,3...2147483648 ] |
tenant nullable | integer Tenant |
tenant_lease_ends nullable | string Tenant lease ends |
tenant_notice_period nullable | string<= 50 characters Tenant notice period |
tenant_rental nullable | integer Tenant rental |
tenant_notes nullable | string Tenant notes |
owner_notes nullable | string Owner notes |
deposit nullable | string Deposit |
sg_code nullable | string<= 30 characters Sg code |
lightstone_id nullable | integer Lightstone id |
lightstone_data nullable | object Lightstone data |
building_name nullable | string<= 60 characters Building name |
erf_number nullable | string<= 40 characters Erf number |
feed_to_portals | boolean Feed to portals |
matterport_id nullable | string<= 100 characters Matterport id |
virtual_tour nullable | string<= 150 characters Virtual tour |
eyespy360 nullable | string<= 150 characters Eyespy360 |
external_link_name nullable | string<= 20 characters External link name |
external_link_url nullable | string<= 200 characters External link url |
property_title nullable | string Property titleChoices: Sectional TitleFreeholdShare BlockLeaseholdLife Rights |
developer nullable | string<= 50 characters Developer |
build_year nullable | integer Build year |
build_completion_status nullable | string Build completion statusChoices: CompletedCompleted PrimaryOff PlanOff Plan Primary |
property_permit nullable | string<= 50 characters Property permit |
permit_expiry_date nullable | string Permit expiry date |
seller_feedback_config nullable | object Seller feedback config |
solar_panel | boolean Solar panel |
solar_geyser | boolean Solar geyser |
gas_geyser | boolean Gas geyser |
water_tank | boolean Water tank |
borehole | boolean Borehole |
backup_battery_inverter | boolean Backup battery inverter |
status required | string StatusChoices: ActivePendingRentedSoldArchivedValuation |
price nullable | string Price |
payment_method nullable | string Payment methodChoices: CashInstalmentCash and Instalment |
down_payment nullable | string Down payment |
renewal_fee nullable | string Renewal fee |
application_fee nullable | string Application fee |
lease_admin_fee nullable | string Lease admin fee |
lease_end_date nullable | string Lease end date |
lease_value nullable | string Lease value |
rental_commission nullable | string Rental commission |
monthly_commission_amount nullable | string Monthly commission amount |
monthly_commission_percent nullable | string Monthly commission percent |
managed | boolean Managed |
monthly_commission_type nullable | string Monthly commission typeChoices: PercentageAmount |
price_reduced | boolean Price reduced |
price_reduced_alert | boolean Price reduced alert |
sold_status_date nullable | string Sold status date |
sold_price nullable | string Sold price |
sold_agent nullable | array of integers Sold agentChoices: [ 1,2,3...2147483648 ] |
price_lease_type nullable | string Price lease typeChoices: NewRenewal |
valuation_price nullable | string Valuation price |
upfront_commission_amount nullable | string Upfront commission amount |
upfront_commission_percent nullable | string Upfront commission percent |
viewing_contact_person nullable | string<= 50 characters Viewing contact person |
viewing_contact_number nullable | string<= 50 characters Viewing contact number |
viewing_notes nullable | string Viewing notes |
extras nullable | string Extras |
disable_repayment_calulator | boolean Disable repayment calulator |
disable_transfer_calulator | boolean Disable transfer calulator |
disable_cost_calulator | boolean Disable cost calulator |
mandate_commission_amount nullable | string Mandate commission amount |
mandate_commission_split nullable | string<= 15 characters Mandate commission split |
land_size nullable | string Land size |
floor_size nullable | string Floor size |
land_size_measurement_type | string Land size measurement typeChoices: Square MetresHectaresSquare FeetAcres |
floor_size_measurement_type | string Floor size measurement typeChoices: Square MetresSquare Feet |
mandate_commission_split_notes nullable | string Mandate commission split notes |
price_term | string Price termChoices: Per MonthPer Year |
lease_period nullable | string Lease periodChoices: 1 month2 months3 months6 months9 months12 months24 months36 months48 months60 months10 year plus15 year plus25 year plus35 year plusNegotiable |
lease_excludes nullable | string Lease excludes |
enable_offers | boolean Enable offers |
offer_status nullable | string Offer statusChoices: Accepting OffersOffer PendingOffer Accepted |
offers_from nullable | string Offers from |
offers_increment nullable | string Offers increment |
supporting_status nullable | string<= 50 characters Supporting status |
farm_name nullable | string<= 200 characters Farm name |
farm_number nullable | string<= 200 characters Farm number |
bank_repossessed | boolean Bank repossessed |
distressed | boolean Distressed |
bank_reference_number nullable | string<= 30 characters Bank reference number |
bank_reg_date nullable | string Bank reg date |
public_tender | boolean Tender |
no_transfer_cost | boolean No transfer cost |
bank_name nullable | string Bank nameChoices: Absa BankNedbankStandard BankFNBSA Home Loans |
bank_assisted_programme nullable | string Bank assisted programmeChoices: ABSAEasySellHelpUsellQuick SellNAS |
quick_sell_options nullable | string Quick sell optionsChoices: Sole MandateOpen Mandate |
quick_sell_ref nullable | string<= 30 characters Quick sell ref |
escalation nullable | string EscalationChoices: NegotiableSpecify % |
annual_escalation nullable | string Annual escalation |
available_from nullable | string Available fromChoices: ImmediatelyNegotiableSpecific Date |
occupation_date nullable | string Occupation date |
mandate_type nullable | string Mandate typeChoices: AuctionCompany ListingExclusiveExpiredMLSOpenPLNReferralSharedSole |
mandate_start_date nullable | string Mandate start date |
mandate_end_date nullable | string Mandate end date |
mandate_reason_for_selling nullable | string Mandate reason for selling |
mandate_notes nullable | string Mandate notes |
mandate_commission_percentage nullable | string<= 20 characters Mandate commission percentage |
on_market_since nullable | string On market since |
listing_type required | string Listing typeChoices: For SaleTo Let |
security | boolean Security |
auction | boolean Auction |
auction_lots nullable | integer Auction lots |
auction_venue nullable | string<= 200 characters Auction venue |
auction_lat nullable | string<= 50 characters Auction lat |
auction_lng nullable | string<= 50 characters Auction lng |
auction_date nullable | string Auction date |
auction_start_time nullable | string Auction start time |
auction_end_time nullable | string Auction end time |
auction_notes nullable | string Auction notes |
subject_to_confirmation | boolean Subject to confirmation |
guide_price nullable | string Guide price |
commission_percentage nullable | string Commission percentage |
reserve_price nullable | string Reserve price |
starting_price nullable | string Starting price |
minimum_bid_increment nullable | string Minimum bid increment |
bid_time_extension nullable | integer Bid time extension |
monthly_rates nullable | string Monthly rates |
rates_period nullable | string Rates periodChoices: Per MonthPer Year |
monthly_levy nullable | string Monthly levy |
sectional_title_levy nullable | string Sectional title levy |
special_levy nullable | string Special levy |
num_shares nullable | integer Num shares |
share_block_number nullable | string<= 15 characters Share block number |
sectional_scheme_name nullable | string<= 128 characters Sectional scheme name |
section_number nullable | string<= 100 characters Section number |
section_plan_number nullable | string<= 15 characters Section plan number |
per_quota nullable | string<= 15 characters Per quota |
body_corp_name nullable | string<= 50 characters Body corp name |
body_corp_chairman nullable | string<= 50 characters Body corp chairman |
body_corp_telephone_number nullable | string<= 30 characters Body corp telephone number |
supervisor_name nullable | string<= 50 characters Supervisor name |
supervisor_telephone_number nullable | string<= 30 characters Supervisor telephone number |
managing_agent nullable | string<= 50 characters Managing agent |
managing_agent_telephone_number nullable | string<= 30 characters Managing agent telephone number |
floor_number nullable | string<= 20 characters Floor number |
payment_frequency nullable | integer Payment frequencyChoices: 123456789101112 |
bathrooms nullable | string Bathrooms |
bathrooms_notes nullable | string Bathrooms notes |
property_notes nullable | string Property notes |
property_sold_rented_to nullable | array of integers Property sold rented toChoices: [ 1,2,3...2147483648 ] |
sold_rented_by_3rd_party | boolean Sold rented by 3rd party |
municipal_value nullable | string Municipal value |
project_name nullable | string<= 100 characters Project name |
furnished | boolean Furnished |
bedrooms nullable | string Bedrooms |
bedrooms_notes nullable | string Bedrooms notes |
study nullable | string Study |
study_notes nullable | string Study notes |
lounges nullable | string Lounges |
lounges_notes nullable | string Lounges notes |
dining_rooms nullable | string Dining rooms |
dining_rooms_notes nullable | string Dining rooms notes |
kitchen nullable | string Kitchen |
kitchen_notes nullable | string Kitchen notes |
laundry nullable | string Laundry |
laundry_notes nullable | string Laundry notes |
patio nullable | string Patio |
patio_notes nullable | string Patio notes |
balcony nullable | string Balcony |
balcony_notes nullable | string Balcony notes |
garages nullable | string Garages |
garages_notes nullable | string Garages notes |
carports nullable | string Carports |
carports_notes nullable | string Carports notes |
parking_type nullable | array of strings Parking typeChoices: CarportDouble ParkingOn Street ParkingShade Net Covered ParkingSingle ParkingSecure ParkingTandem ParkingTriple ParkingUnderground ParkingVisitors Parking |
flatlet nullable | string Flatlet |
flatlet_notes nullable | string Flatlet notes |
domestic_accommodation nullable | string Domestic accommodation |
domestic_accommodation_notes nullable | string Domestic accommodation notes |
flooring nullable | array of strings FlooringChoices: CarpetCementLaminateMarbleParquetPolishedSlastoSlateTilesVinylWood |
flooring_notes nullable | string Flooring notes |
exterior nullable | array of strings ExteriorChoices: BlockBrickClinkerConcreteFace BrickIronNutecPlasterStoneTileVacant LandWoodZincalume |
exterior_notes nullable | string Exterior notes |
roof nullable | array of strings RoofChoices: AluminiumAsbestosConcreteIronShingleSlateThatchTileVacant LandColour Steel |
roof_notes nullable | string Roof notes |
pool | boolean Pool |
pool_notes nullable | string Pool notes |
garden_type nullable | array of strings Garden typeChoices: Above RoadBackyard AccessCommunalGreenhouseIndigenousLandscapedLevelManicuredOvergrownRockySlopedSteepTerracedTidy |
garden_type_notes nullable | string Garden type notes |
sea_views | boolean Sea views |
sea_views_notes nullable | string Sea views notes |
security_notes nullable | string Security notes |
store_room | boolean Store room |
store_room_notes nullable | string Store room notes |
walling nullable | array of strings WallingChoices: Chicken WireElectricFace BrickFully FencedFully WalledPalisadePartly FencedPartly WalledPrecastVacant LandOpenElectric Fence |
walling_notes nullable | string Walling notes |
pets_allowed | boolean Pets allowed |
pets_notes nullable | string Pets notes |
nhbrc | boolean Nhbrc |
private_seller | boolean Private seller |
retirement_unit | boolean Retirement unit |
student_accommodation | boolean Student accommodation |
property_type required | string Property typeChoices: Apartment BlockApartmentBed & BreakfastBuildingBungalowClubClusterCompoundDetachedDuetDuplexEquestrian PropertyFarmFlatFreeholdFreestandingFull FloorGarden CottageGated EstateGolf EstateGuest HouseHalf FloorHotel RoomHotelHouseLabour CampLeasebackLodgeMaisonettePackage HomePenthouseRetirement UnitRoomSectional TitleSemi DetachedSimplexSmall HoldingStudio ApartmentTownhouseVacant LandVilla |
open_hour_date nullable | string Open hour date |
open_hour_time nullable | string Open hour time |
open_hour_agent nullable | string<= 50 characters Open hour agent |
open_hour_agent_telephone_number nullable | string<= 30 characters Open hour agent telephone number |
bond_bank nullable | string<= 80 characters Bond bank |
bond_bank_branch nullable | string<= 80 characters Bond bank branch |
bond_bank_account_number nullable | string<= 80 characters Bond bank account number |
bond_bank_balance nullable | string<= 30 characters Bond bank balance |
managing_agent_email nullable | string<= 254 characters Managing agent email |
body_corp_email nullable | string<= 254 characters Body corp email |
supervisor_email nullable | string<= 254 characters Supervisor email |
home_owner_levy nullable | string Home owner levy |
statistics nullable | integer Statistics |
quality nullable | integer Quality |
project nullable | integer Project |