Property: put

Update a Property.

Request - PUT https://api-uat.vtopenview.com/property/{propertyid}

You will need to supply a request body and supply the Property Id on your request parameters with this method.
You will need to include your access token upon making a request. For more information, see the authentication and authorization page.

Example request with authorization:

curl -- POST Base URI: https://api-uat.vtopenview.com/property/{propertyid}
--header "Authorization: Bearer MTQ0NjJkZmQ5OTM2NDE1ghNNBiuyUYUN"

Request Body
Example request body:

Content-Type: application/json
{
"propertyid": long,
"address": {
"houseno": "string",
"address1": "string",
"address2": "string",
"town": "string",
"county": "string",
"postcode": "string",
"latitude": decimal,
"longitude": decimal,
"geocodingverified": boolean,
"countryname": "string",
"countrydisplayname": "string",
"fulladdress": "string",
"shortaddress": "string"
},
"internalreference": "string",
"negotiator": {
"userid": long,
"name": "string",
"email": "string"
},
"branch": {
"branchid": integer,
"branchname": "string"
},
"status": "string",
"archived": boolean,
"appraisal": boolean,
"priceprefix": "string",
"price": decimal,
"pricecurrency": "string",
"instructeddate": "date",
"contracttype": "string",
"contractexpires": "date",
"feeamount": decimal,
"feetype": "string",
"commissionamount": decimal,
"commissiontype": "string",
"vendors": [
{
"vendorid": long,
"name": "string",
"email": "string",
"primary": boolean,
}
],
"solicitor": [
{
"instructed": boolean,
"instructeddate": "date",
"solicitor": "string",
"contact": "string",
"address": "string",
"contactemail": "string",
"contactphone": "string",
"contactmobile": "string",
"contactfax": "string",
}
],
"information": {
"ukcouncil": "string",
"counciltaxband": "string",
"occupier": "string",
"occupierothername": "string",
"tenure": {
"type": "string",
"expirydate": "string",
},
"alarm": {
"alarmed": boolean,
"alarmcode": "string",
},
},
"marketing": {
"priceprefix": "string",
"price": decimal,
"bedrooms": integer,
"bathrooms": integer,
"receptions": integer,
"currency": "string"
"advertising": {
"advertise": boolean,
"newbuild": boolean,
"propertyarea": "string",
"virtualtoururl": "string",
"virtualtourtwourl": "string",
"advertisingstatus": "string",
"advertisingaddress": "string",
"advertisingurl": "string",
},
"matching": {
"propertytype": "string",
"propertytypezoopla": "string",
"propertyattributes": [
{
"attribute": "string",
}
],
},
"descriptions": {
"main": "string",
"summary": "string",
"extra1": "string",
"extra2": "string",
"advertisingsmsmessage": "string",
},
"others": {
"landusage": "string",
"size": integer,
"measurementunits": "string",
"directions": "string",
},
},
"udf": [
{
"udfid": long,
"value": "string"
}
]
}

Status:

The list below describes the possible status for properties. This field is required.
If your company has set up other statuses on OpenView, please verify the string you are sending.

Prospect
Live
Archived

Example field on request:

"status": "Live"

Solicitor:

The name of solicitor that is set up on OpenView for your company. This field is optional.

Example field on request:

"solicitor": "Solicitor's Name"

Contract Type:

The list below describes the possible Contract Types for properties. This field is optional.

Fixed Fee
Joint Agency Agreement
Multi-Agency Agreement
Sole Agency Agreement
Sole Selling Agreement

Example field on request:

"contracttype": "Joint Agency Agreement"

Information Tenure Type:

The list below describes the possible Tenure types for properties. This field is optional.

Freehold
Leasehold
Feudal
Commonhold
Share of Freehold

Example field on request:

"tenure"."type": "Leasehold"

Information Occupier:

The list below describes the possible Occupier types for properties. This field is optional.

Vendor
Tenant
Vacant
Other

Example field on request:

"occupier": "Vendor"

Marketing Price Prefix:

The list below describes the possible Price Prefix types for properties. This field is optional.

Offers In Excess Of
Offers In The Region Of
Guide Price
Fixed Price
OIRO
Default
POA
Sale by Tender
From
Shared Ownership
Offers Over
Part Buy Part Rent
Shared Equity

Example field on request:

"priceprefix": "Offers In Excess Of"

Marketing Advertising Status:

The list below describes the possible Advertising Status types for properties. This field is optional.

Available
Let Agreed
Under Offer

Example field on request:

"advertisingstatus": "Let Agreed"

Marketing Matching Property Type:

The list below describes the possible Property types for properties. This follow the same property types from Rightmove. This field is optional.

Not Specified
Terraced House
End of Terrace House
Semi-Detached House
Detached House
Mews House
Cluster House
Ground Floor Flat
Flat
Studio Flat
Ground Floor Maisonette
Maisonette
Bungalow
Terraced Bungalow
Semi-Detached Bungalow
Detached Bungalow
Mobile Home
Land (Residential)
Link Detached House
Town House
Cottage
Chalet
Character Property
House
Villa
Apartment
Penthouse
Fina
Barn Conversion
Serviced Apartment
Parking
Sheltered Housing
Retirement Property
House Share
Flat Share
Park Home
Garages
Farm House
Equestrian Facility
Duplex
Triplex
Longere
Gite
Barn
Trulli
Mill
Ruins
Restaurant
Cafe
Castle
Village House
Cave House
Cortijo
Farm Land
Plot
Country House
Stone House
Caravan
Lodge
Log Cabin
Manor House
Stately home
Off-Plan
Semi-Detached Villa
Detached Villa
Bar/Nightclub
Shop
Riad
House Boat
Hotel Room
Block of Apartments
Private Halls
Office
Business Park
Serviced Office
Retail Property (High Street)
Retail Property (Out of Town)
Convenience Store
Hairdresser/Barber Shop
Hotel
Petrol Station
Post Office
Pub
Workshop & Retail Space
Distribution Warehouse
Factory
Heavy Industrial
Industrial Park
Light Industrial
Storage
Showroom
Warehouse
Land (Commercial)
Commercial Development
Industrial Development
Residential Development
Commercial Property
Data Centre
Farm
Healthcare Facility
Marine Property
Mixed Use
Research & Development Facility
Science Park
Guest House
Hospitality
Leisure Facility
Takeaway
Childcare Facility
Smallholding
Place of Worship
Trade Counter
Coach House
House of Multiple Occupation
Sports facilities
Spa
Campsite & Holiday Village

Example field on request:

"propertytype": "Detached House"

Marketing Matching Property Type Zoopla:

The list below describes the possible Property types for properties. This follow the same property types from Zoopla. This field is optional.

Terraced
End Terrace
Semi Detached
Detached
Mews
Flat
Studio
Maisonette
Bungalow
Terraced Bungalow
Semi-Detached Bungalow
Detached Bungalow
Land
Link Detached
Town House
Cottage
Chalet
Villa
Finca
Barn Conversion
Parking
Park Home
Farmhouse
Equestrian
Longere
Restaurant
Chateau
Country House
Lodge
Retail
Riad
House Boat
Block of Flats
Office
Business Park
Hotel
Pub/Bar
Industrial
Light Industrial
Warehouse
Farm
Leisure

Example field on request:

"propertytypezoopla": "Detached"

Marketing Others Measurement Units:

The list below describes the possible Measurement Units types for properties. This field is optional.

sqm
sqft

Example field on request:

"measurementunits": "sqft"

Response

If successful, this method returns a response body with the following structure:

Example response:

HTTPS 200 OK
Content-Type: application/json
{
"sales_properties": [
{
"propertyid": long,
"address": {
"houseno": "string",
"address1": "string",
"address2": "string",
"town": "string",
"county": "string",
"postcode": "string",
"latitude": decimal,
"longitude": decimal,
"geocodingverified": boolean,
"countryname": "string",
"countrydisplayname": "string",
"fulladdress": "string",
"shortaddress": "string"
},
"internalreference": "string",
"negotiator": {
"userid": long,
"name": "string",
"email": "string"
},
"branch": {
"branchid": integer,
"branchname": "string"
},
"status": "string",
"archived": boolean,
"appraisal": boolean,
"priceprefix": "string",
"price": decimal,
"pricecurrency": "string",
"instructeddate": "date",
"contracttype": "string",
"contractexpires": "date",
"feeamount": decimal,
"feetype": "string",
"commissionamount": decimal,
"commissiontype": "string",
"vendors": [
{
"vendorid": long,
"name": "string",
"email": "string",
"primary": boolean,
}
],
"solicitor": [
{
"instructed": boolean,
"instructeddate": "date",
"solicitor": "string",
"contact": "string",
"address": "string",
"contactemail": "string",
"contactphone": "string",
"contactmobile": "string",
"contactfax": "string",
}
],
"compliance": {
"safetychecks": [
{
"type": "string",
"responsability": "string",
"duedate": "date",
"boilerservice": boolean,
}
],
"energyefficiencycurrent": integer,
"energyefficiencypotential": integer,
"enviromentalimpactcurrent": integer,
"enviromentalimpactpotential": integer,
"epc": {
"rrnnumber": "string",
"expirydate": "date",
},
"notes": "string"
},
"information": {
"ukcouncil": "string",
"counciltaxband": "string",
"occupier": "string",
"occupierothername": "string",
"tenure": {
"type": "string",
"expirydate": "string",
},
"alarm": {
"alarmed": boolean,
"alarmcode": "string",
},
},
"marketing": {
"priceprefix": "string",
"price": decimal,
"bedrooms": integer,
"bathrooms": integer,
"receptions": integer,
"currency": "string"
"advertising": {
"advertise": boolean,
"newbuild": boolean,
"propertyarea": "string",
"virtualtoururl": "string",
"virtualtourtwourl": "string",
"advertisingstatus": "string",
"advertisingaddress": "string",
"advertisingurl": "string",
},
"matching": {
"propertytype": "string",
"propertytypezoopla": "string",
"propertyattributes": [
{
"attribute": "string",
}
],
},
"descriptions": {
"main": "string",
"summary": "string",
"extra1": "string",
"extra2": "string",
"advertisingsmsmessage": "string",
},
"others": {
"landusage": "string",
"size": integer,
"measurementunits": "string",
"directions": "string",
},
},
"media": [
{
"type": "string",
"caption": "string",
"urlprimary": "string",
"urlsmall": "string",
"urllarge": "string",
"room": "string",
"roomtype": "string",
"dateadded": "datetime",
}
],
"udf": [
{
"udfid": long,
"value": "string"
}
]
}
]
}