Landlords: list

Return information about all landlords in a company.
Optional Email query parameter to filter by Email.

Request - GET https://api-uat.vtopenview.com/landlords?email={email}

DO NOT supply a request body and a request parameter with this method.
Email query param is optional You can supply it to filter by Landlord email.
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 -- GET Base URI: https://api-uat.vtopenview.com/landlords?pageNumber={pageNumber}&pageSize={pageSize} --header "Authorization: Bearer MTQ0NjJkZmQ5OTM2NDE1ghNNBiuyUYUN"

Response

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

Example response:

HTTPS 200 OK Content-Type: application/json { "landlord_records_pages": integer, "landlord_records_current_page": integer, "landlords": [ { "landlordid": long, "title": "string", "forename": "string", "surname": "string", "companyname": "string", "website": "string", "phone": "string", "workphone": "string", "mobilephone": "string", "email": "string", "salutation": "string", "agreementname": "string", "source": "string", "lettingsreason": "string", "internalreference": "string", "archivedDate": "date", "addedDate": "date", "modifiedDate": "date", "negotiator": { "userid": long, "name": "string", "email": "string" }, "branch": { "branchid": integer, "branchname": "string" }, "status": "string", "overseas": "string", "taxenabled": "string", "excludefrompayments": boolean, "registrationnumber": "string", "cnrnumber": "string", "cnrapprovaldate": "string", "taxrate": decimal, "vatregistration": "string", "hmrcduedate": "date", "statement": "string", "sendstatementvia": "string", "safedepositstype": "string", "safedepositsregnumber": "string", "financialnotes": "string", "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" }, "properties": [ { "propertyid": long, "shortaddress": "string", "fulladdress": "string", "numberoftenants": integer, "rent": decimal, "deposit": decimal, "bedrooms": integer, "bathrooms": integer, "receptions": integer, } ], "GDPR": { "donotcontact": boolean, "Email": boolean, "letter": boolean, "sms": boolean, "phone": boolean", "allowthirdparty":boolean, "allowmarketing": boolean, }, "udf": [ { "udfid": long, "fieldName": string, "dataType": string, "value": string, "required": boolean, "options": [ { "text": string, "value": integer } ] } ] } ] }

UDF Data type:

The list below describes the possible date type of UDFs.

text
integer
datetime
datetime
decimal
money
percentage
yes/no
select
multi

Example field on response:

{ ... "dataType": "decimal", "value": "0.00" }, { ... "dataType": "multi", "value": "1,2" "options": [ { "text": "Ensuite Bathroom", "value": 1 }, { "text": "Central Heating", "value": 2 } ] },