Applicants: list

Return information about all applicants in a company.
With a nullable email filter.

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

DO NOT supply a request body and a request parameter 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 -- GET Base URI: https://api-uat.vtopenview.com/applicants?email={email}
--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
{
"applicants": [
{
"applicantid": long,
"lettings": boolean,
"sales": boolean,
"title": "string",
"forename": "string",
"surname": "string",
"companyname": "string",
"website": "string",
"phone": "string",
"workphone": "string",
"mobilephone": "string",
"email": "string",
"salutation": "string",
"source": "string",
"temperature": "string",
"AddedDate": "date",
"ModifiedDate": "date",
"internalreference": "string",
"archivedDate": "date",
"negotiator": {
"userid": long,
"name": "string",
"email": "string"
},
"branch": {
"branchid": integer,
"branchname": "string"
},
"status": "string",
"contactnotes": "string",
"additionalinformation": "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"
},
"criteria":
{
"areas": [
{
"area": "string",
"miles": decimal,
}
],
"minprice": decimal,
"maxprice": decimal,
"bedrooms": integer,
"bathrooms": integer,
"moveindate": "date",
"buyerposition": "string",
"propertyattributes": [
{
"attribute": "string",
}
],
"propertystyle": [
{
"style": "string",
}
],
"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
}
]
},