Tenancies: get
Return information about the tenancy in a company Filter By Modified Date.
Request - GET https://api.vtopenview.com/modifiedDate/MM-DD-YYYY
You will need to supply the Tenancy Id on your request parameters with this method. You can get your Tenancy Id from the return of the Tenancy List.
You will need to sent on request your access token. For more information, see the authentication and authorization page.
Example request with authorization:
curl -- GET Base URI: https://api.vtopenview.com/tenancies/modifiedDate/{modifiedDate}
--header "Authorization: Bearer MTQ0NjJkZmQ5OTM2NDE1ghNNBiuyUYUN"
Response
If successful, this method returns a response body with the following structure:
Example response:
HTTPS 200 OK
Content-Type: tenancy/json
{
"tenancies": [
{
"tenancyid": long,
"reference": "string",
"negotiator": {
"userid": long,
"name": "string",
"email": "string"
},
"branch": {
"branchid": integer,
"branchname": "string"
},
"status": "string",
"archived": boolean,
"prebooked": boolean,
"rent": decimal,
"deposit": decimal,
"holdingdeposit": decimal,
"collectionday": "string",
"nextrentdue": "date",
"rentperiod": "string",
"occupation": "string",
"employer": "string",
"ninumber": "string",
"agreementname": "string",
"renttype": "string",
"autorentinvoice": boolean,
"usealternateaddress": boolean,
"housingbenefit": boolean,
"casenumber": "string",
"hbchargedahead": boolean,
"hbchargedarrears": boolean,
"contactnotes": "string",
"property": [
{
"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"
}
]
}
],
"tenancyAddedDate": "date",
"tenancyModifiedDate": "date",
"tenancystart": "date",
"tenancyend": "date",
"renewalstart": "date",
"vacatingdate": "date",
"visitnextdue": "date",
"leaseperiod": "string",
"relocationagent": "string",
"agreementname": "string",
"agreementsigned": boolean,
"followup": boolean,
"notes": "string",
"breakclause": "string",
"noticenotes": "string",
"primarytenant": [
{
"tenantid": long,
"name": "string",
"email": "string",
"rent": decimal,
"deposit": decimal,
"initialrent": decimal,
"finalrent": decimal,
"totalrent": decimal,
"rentperiod": "string",
"collectiondate": "date",
"nextrentdue": "date",
"rentreview": "date",
"thereafter": integer,
"inccharge": decimal,
"erv": decimal,
"ervvariance": decimal,
}
],
"tenants": [
{
"tenantid": long,
"name": "string",
"email": "string",
"address": "string",
"primarytenant": boolean,
"archived": boolean,
"archivedDate": "date",
}
],
"compliance": {
"section21": {
"section21served": boolean,
"servedby": "string",
"servednotes": "string",
"lanoticeserved": boolean,
"lanoticeservednotes": "string",
},
"depositprotection": {
"scheme": "string",
"heldby": "string",
"reference": "string",
"transferred": boolean,
"depositregistered": boolean,
"tenantnotified": boolean,
"remind": boolean,
}
},
"information": {
"housingbenefit": {
"usehousingbenefit": boolean,
"nextrentdue": "date",
"rent": decimal,
"rentperiod": "string",
"arrears": boolean,
"ahead": boolean,
"notes": "string",
}
}
}
]
}