RentProfile API documentation

Last updated: December 9th, 2022

Overview

Introduction

We offer REST API’s for trusted organisations looking to create more integrated, customised experiences.

Definitions

Request ID (request_id) - a unique identifier of the Tenant/Guarantor Check request, this is automatically assigned when the check request is initially submitted and will be returned in the response.

Combined (combined) - indicator for if the affordability should be calculated from the total rent for all the applicants of the same rental address, rather than individually (only applies to renters).

Landlord AML ID (landlord_aml_id) - a unique static identifier (set by you) for each user you wish to run a Landlord AML Check on.

Our API's



Invite API

The Invite API replicates making a Tenant or Guarantor Check request in our Agent Dashboard.

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below you wish to check against.

  • "api_key"
  • "address_line1"
  • "postcode"
  • "total_rent"
  • "applicant_name"
  • - then at least one of these parameters listed below -
  • "applicant_email"
  • "applicant_mobile"
  • - optional parameters listed below -
  • "town"
  • "city"
  • "applicant_months_upfront"
  • "branch_id"
  • "combined"
  • "rent_per_person"
  • "aml_required"
  • "client_name"
  • "client_type"
  • "client_email"
  • "client_phone"

Note: Up to 10 applicants can be invited at once, use the applicant_is_guarantor_for option if the applicant is a guarantor.
If renters are paying rent upfront use the applicant_months_upfront params to provide the number of months.
For example "6" for 6 months rent upfront.

If the request has been made on behalf of a client then "client_name", "client_email", "client_phone", "client_type" (for example: "landlord" or "agent") can be optionally provided.

To request AML (Anti Money Laundering) checks on the applicants set aml_required as "true"

Invite API Method

The request type is POST

Invite API Data Params

Invite API Request Data Param Types
{
    api_key : [string],
    branch_id : [string],
    address_line1 : [string],
    town : [string],
    city : [string],
    postcode : [string],
    combined : [string],
    total_rent : [string],
    rent_per_person : [string],
    aml_required : [string],
    applicant_name : [string],
    applicant_email : [string],
    applicant_mobile : [string],
    applicant_is_guarantor_for : [string],
    applicant_months_upfront : [string],
    applicant_name_2 : [string],
    applicant_email_2 : [string],
    applicant_mobile_2 : [string],
    applicant_is_guarantor_for_2 : [string],
    applicant_months_upfront_2 : [string],
    applicant_name_3 : [string],
    applicant_email_3 : [string],
    applicant_mobile_3 : [string],
    applicant_is_guarantor_for_3 : [string],
    applicant_months_upfront_3 : [string],
    applicant_name_4 : [string],
    applicant_email_4 : [string],
    applicant_mobile_4 : [string],
    applicant_is_guarantor_for_4 : [string],
    applicant_months_upfront_4 : [string],
    applicant_name_5 : [string],
    applicant_email_5 : [string],
    applicant_mobile_5 : [string],
    applicant_is_guarantor_for_5 : [string],
    applicant_months_upfront_5 : [string],
    applicant_name_6 : [string],
    applicant_email_6 : [string],
    applicant_mobile_6 : [string],
    applicant_is_guarantor_for_6 : [string],
    applicant_months_upfront_6 : [string],
    applicant_name_7 : [string],
    applicant_email_7 : [string],
    applicant_mobile_7 : [string],
    applicant_is_guarantor_for_7 : [string],
    applicant_months_upfront_7 : [string],
    applicant_name_8 : [string],
    applicant_email_8 : [string],
    applicant_mobile_8 : [string],
    applicant_is_guarantor_for_8 : [string],
    applicant_months_upfront_8 : [string],
    applicant_name_9 : [string],
    applicant_email_9 : [string],
    applicant_mobile_9 : [string],
    applicant_is_guarantor_for_9 : [string],
    applicant_months_upfront_9 : [string],
    applicant_name_10 : [string],
    applicant_email_10 : [string],
    applicant_mobile_10 : [string],
    applicant_is_guarantor_for_10 : [string],
    applicant_months_upfront_10 : [string],
    client_name : [string],
    client_type : [string],
    client_email : [string],
    client_phone : [string]
}
Invite API Request Data Params Example
{
    "api_key":"longrandomstringforapikey123456",
    "branch_id":"71",
    "address_line1":"32 London Bridge Street",
    "city":"London",
    "postcode":"SE1 9SG",
    "combined":"true",
    "total_rent":"£2000",
    "rent_per_person":"£1000",
    "applicant_name":"Anna Stevens",
    "applicant_email":"example@renter.com",
    "applicant_mobile":"07123456789",
    "applicant_name_2":"Tom Smith",
    "applicant_email_2":"example2@renter.com",
    "applicant_name_3":"Jane Smith",
    "applicant_email_3":"example@guarantor.com",
    "applicant_mobile_3":"07987654321",
    "applicant_is_guarantor_for_3":"Tom Smith"
}
Invite API Response Data Param Types
{
    applicant_name : [string],
    request_id : [string],
    applicant_name_2 : [string],
    request_id_2 : [string],
    applicant_name_3 : [string],
    request_id_3 : [string],
    applicant_name_4 : [string],
    request_id_4 : [string],
    applicant_name_5 : [string],
    request_id_5 : [string],
    applicant_name_6 : [string],
    request_id_6 : [string],
    applicant_name_7 : [string],
    request_id_7 : [string],
    applicant_name_8 : [string],
    request_id_8 : [string],
    applicant_name_9 : [string],
    request_id_9 : [string],
    applicant_name_10 : [string],
    request_id_10 : [string]
}
Invite API Response Data Params Example
{
   "applicant_name":"Anna Stevens",
   "request_id":"3d51225d80",
   "applicant_name_2":"Tom Smith",
   "request_id_2":"837y4uie34",
   "applicant_name_3":"Jane Smith",
   "request_id_3":"d4jvrow237"
}

Multiple Request ID's (request_id, request_id_2, request_id_3 etc.) will be in the response if multiple applicants are submitted at the same time.

Invite API Endpoint

https://www.rentprofile.co/v1/api/invite/request
Invite API Request Example
curl -H "Content-Type: application/json" -X POST -d '{"branch_id":"71","address_line1":"32 London Bridge Street","city":"London","postcode":"SE1 9SG","rent_per_person":"£1000","combined":"true","total_rent":"£2000","applicant_name":"Anna Stevens","applicant_email":"example@renter.com","applicant_mobile":"07123456789","applicant_name_2":"Tom Smith","applicant_email_2":"example2@renter.com","applicant_name_3":"Jane Smith","applicant_email_3":"example@guarantor.com","applicant_mobile_3":"07987654321","applicant_is_guarantor_for_3":"Tom Smith","api_key":"replace_this_with_the_api_key"}' https://www.rentprofile.co/v1/api/invite/request
Invite API Response Example
{"applicant_name":"Anna Stevens","request_id":"3d51225d80","applicant_name_2":"Tom Smith","request_id_2":"837y4uie34","applicant_name_3":"Jane Smith","request_id_3":"d4jvrow237"}

Cancel API

The Cancel API replicates the cancelling of Tenant of Guarantor Referencing Check in our Agent Dashboard.

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below you wish to check against.

  • "api_key"
  • "request_id"

Cancel API Method

The request type is POST

Cancel API Data Params

Cancel API Request Data Param Types
{
    api_key : [string],
    request_id : [string]
}
Cancel API Request Data Params Example
{
    "api_key":"longrandomstringforapikey123456",
    "request_id":"3d51225d80"
}
Cancel API Response Data Param Types
{
    request_id : [string],
    status : [string]
}
Cancel API Response Data Params Example
{
   "request_id":"3d51225d80",
   "status":"Cancelled"
}

Notes on responses:
status responses can be "Cancelled", "Unable to find Invite"

The "Cancelled" status response will only display at the time the invite is cancelled, if a cancelled invite is requested to be cancelled again the response will be "Unable to find Invite" as it will have been removed.

Cancel API Endpoint

https://www.rentprofile.co/v1/api/invite/cancel
Cancel API Request Example
$ curl -H "Content-Type: application/json" -X POST -d '{"request_id":"3d51225d80","api_key":"replace_this_with_the_api_key"}' https://www.rentprofile.co/v1/api/invite/cancel
Cancel API Response Example
{"request_id":"3d51225d80","status":"Cancelled"}



Status API

The Status API replicates the status in our Agent Dashboard displaying the progress of the Tenant or Guarantor Check. As an alternative to a Status API request there is a webhook available. If the webhook is required provide the URL for the Status API response to be sent to when the report is updated (Full details required for the webhook is enabled by default).

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below you wish to check against.

  • "api_key"
  • - then at least one of these parameters listed below -
  • "request_id"
  • - optional parameters listed below -
  • "full_details_required"
  • "branch_id" - coming soon
  • "name" - coming soon
  • "address_line1" and "postcode" - coming soon

Status API Method

The request type is POST

Status API Data Params

Status API Request Data Param Types
{
    api_key : [string],
    request_id : [string],
    full_details_required : [string]
}
Status API Request Data Params Example
{
    "api_key":"longrandomstringforapikey123456",
    "request_id":"3d51225d80"
}
Status API Response Data Param Types
{
    request_id : [string],
    status : [string],
    branch_id : [string],
    address : [string],
    name : [string],
    email_address : [string],
    mobile : [string],
    renter_or_guarantor : [string],
    invite_date : [string],
    profile_link : [string],
    combined : [string],
    rent_upfront : [string],
    months_upfront : [string],
    rent_amount : [string],
    affordability : [string],
    ownership : [string],
    thumbnail : [string],
    ccj : [string],
    bankruptcy : [string],
    credit_file_adverse_findings : [string],
    identity : [string],
    pets : [string],
    dependents : [string],
    right_to_rent : [string],
    employment_type : [string],
    employment_term : [string],
    employer : [string],
    job_title : [string],
    position : [string],
    probation : [string],
    start_month : [string],
    start_year : [string],
    workplace_manager_verified : [string],
    type_of_self_employed_company : [string],
    extra_self_employed_info : [string],
    registered_since : [string],
    strike_actions : [string],
    business_ccj : [string],
    director : [string],
    accountant_verified : [string],
    salary : [string],
    uk_bank_account : [string],
    risk_score : [string],
    renter_or_guarantor : [string],
    additional_information : [string],
    not_provided : [string],
    first_rental : [string],
    landlord_or_agent_name : [string],
    rental_dates : [string],
    rent_on_time : [string],
    property_in_good_condition : [string],
    no_rent_arrears : [string],
    recommend : [string],
    landlord_or_agent_name_2 : [string],
    rental_dates_2 : [string],
    rent_on_time_2 : [string],
    property_in_good_condition_2 : [string],
    no_rent_arrears_2 : [string],
    recommend_2 : [string],
    landlord_or_agent_name_3 : [string],
    rental_dates_3 : [string],
    rent_on_time_3 : [string],
    property_in_good_condition_3 : [string],
    no_rent_arrears_3 : [string],
    recommend_3 : [string],
    landlord_or_agent_name_4 : [string],
    rental_dates_4 : [string],
    rent_on_time_4 : [string],
    property_in_good_condition_4 : [string],
    no_rent_arrears_4 : [string],
    recommend_4 : [string],
    landlord_or_agent_name_5 : [string],
    rental_dates_5 : [string],
    rent_on_time_5 : [string],
    property_in_good_condition_5 : [string],
    no_rent_arrears_5 : [string],
    recommend_5 : [string],
    aml : [string],
    sanctions : [string],
    pep : [string],
    rca : [string],
    sip : [string],
    ool : [string]
}
Status API Response Data Params Example
{
   "request_id":"3d51225d80",
   "status":"Complete",
   "branch_id":"71",
   "address":"32 London Bridge Street, London, SE1 9SG",
   "renter_or_guarantor":"renter",
   "invite_date":"24/09/2018",
   "profile_link":"https://www.rentprofile.co/r/examplerenter",
   "combined":"true",
   "rent_upfront":"false",
   "rent_amount":"£2,000",
   "affordability":"£2450",
   "name":"Anna Stevens",
   "email_address":"example@renter.com",
   "mobile":"0712345****",
   "thumbnail":"https://s3-eu-west-1.amazonaws.com/rentprofile/tenantprofile/profile/eugyih/eugyih.jpg",
   "ccj":"pass",
   "bankruptcy":"pass",
   "credit_file_adverse_findings":"pass",
   "identity":"pass",
   "pets":"false",
   "dependents":"false",
   "right_to_rent":"true",
   "employment_type":"Employed",
   "employment_term":"Permanent",
   "employer":"Gulbenkian Andonian Solicitors",
   "job_title":"Trainee Solicitor",
   "position":"Full-time",
   "probation":"No",
   "start_month":"May",
   "start_year":"2016",
   "workplace_manager_verified":"true",
   "salary":"£32,000",
   "uk_bank_account":"true",
   "not_provided":"false",
   "first_rental":"false",
   "landlord_or_agent_name":"Michael T",
   "rental_dates":"April 2015 until March 2016",
   "rent_on_time":"true",
   "property_in_good_condition":"true",
   "no_rent_arrears":"true",
   "recommend":"true"
}

Notes on responses:
status responses can be "Waiting on applicant", "Waiting on co-applicants", "In review", "Waiting on refs & ID", "Waiting on references", "Waiting on landlord ref & ID", "Waiting on workplace ref & ID", "Waiting on earnings & ID", "Waiting on landlord reference", "Waiting on workplace reference", "Waiting on earnings", "Waiting on ID", "Processing", "Complete"

To request full details to be provided in the response, set full_details_required as "true".

The url to the profile (profile_link) will only be returned if the Status is Complete.

Status API Endpoint

https://www.rentprofile.co/v1/api/status/request
Status API Request Example
$ curl -H "Content-Type: application/json" -X POST -d '{"request_id":"3d51225d80","full_details_required":"true","api_key":"replace_this_with_the_api_key"}' https://www.rentprofile.co/v1/api/status/request
Status API Response Example
{"request_id":"3d51225d80","status":"Complete","branch_id":"71","address":"32 London Bridge Street, London, SE1 9SG","renter_or_guarantor":"renter","invite_date":"24/09/2018","profile_link":"https://www.rentprofile.co/r/examplerenter","combined":"true","rent_upfront":"false","rent_amount":"£2,000","affordability":"£2450","name":"Anna Stevens","email_address":"example@renter.com","mobile":"0712345****","thumbnail":"https://s3-eu-west-1.amazonaws.com/rentprofile/tenantprofile/profile/eugyih/eugyih.jpg","ccj":"pass","bankruptcy":"pass","credit_file_adverse_findings":"pass","identity":"pass","pets":"false","dependents":"false","right_to_rent":"true","employment_type":"Employed","employment_term":"Permanent","employer":"Gulbenkian Andonian Solicitors","job_title":"Trainee Solicitor","position":"Full-time","probation":"No","start_month":"May","start_year":"2016","workplace_manager_verified":"true","salary":"£32,000","uk_bank_account":"true","not_provided":"false","first_rental":"false","landlord_or_agent_name":"Michael T","rental_dates":"April 2015 until March 2016","rent_on_time":"true","property_in_good_condition":"true","no_rent_arrears":"true","recommend":"true"}

Status API Demo

You can use the request id 3d51225d80 to try the Status API. Optionally use true for Full Details Required.




Result API

The Result API replicates the information provided in a Tenant or Guarantor Check Report. As an alternative to a Result API request there is a webhook available. If the webhook is required provide the URL for the Result API response to be sent to when the report is processed (PDF required for the webhook is enabled by default).

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below you wish to check against.

  • "api_key"
  • - then at least one of these parameters listed below -
  • "request_id"
  • "name" - coming soon
  • - optional parameters listed below -
  • "pdf_required"

Result API Method

The request type is POST

Result API Data Params

Result API Request Data Param Types
{
    api_key : [string],
    request_id : [string],
    pdf_required : [string]
}
Result API Request Data Params Example
{
    api_key : "longrandomstringforapikey123456",
    request_id : "3d51225d80",
    pdf_required :  "true"
}

- To request the PDF to be generated and the link to it provided in the response, set pdf_required as "true".
- To whitelist IP addresses for access to all PDF documents (recommended) contact technical support.

Result API Response Data Param Types
{
    request_id : [string],
    branch_id : [string],
    address : [string],
    processed_date : [string],
    combined : [string],
    rent_upfront : [string],
    months_upfront : [string],
    rent_amount : [string],
    affordability : [string],
    ownership : [string],
    profile_link : [string],
    name : [string],
    email_address : [string],
    mobile : [string],
    thumbnail : [string],
    ccj : [string],
    bankruptcy : [string],
    credit_file_adverse_findings : [string],
    identity : [string],
    pets : [string],
    dependents : [string],
    right_to_rent : [string],
    employment_type : [string],
    employment_term : [string],
    employer : [string],
    job_title : [string],
    position : [string],
    probation : [string],
    start_month : [string],
    start_year : [string],
    workplace_manager_verified : [string],
    type_of_self_employed_company : [string],
    extra_self_employed_info : [string],
    registered_since : [string],
    strike_actions : [string],
    business_ccj : [string],
    director : [string],
    accountant_verified : [string],
    salary : [string],
    uk_bank_account : [string],
    risk_score : [string],
    renter_or_guarantor : [string],
    not_provided : [string],
    first_rental : [string],
    landlord_or_agent_name : [string],
    rental_dates : [string],
    rent_on_time : [string],
    property_in_good_condition : [string],
    no_rent_arrears : [string],
    recommend : [string],
    landlord_or_agent_name_2 : [string],
    rental_dates_2 : [string],
    rent_on_time_2 : [string],
    property_in_good_condition_2 : [string],
    no_rent_arrears_2 : [string],
    recommend_2 : [string],
    landlord_or_agent_name_3 : [string],
    rental_dates_3 : [string],
    rent_on_time_3 : [string],
    property_in_good_condition_3 : [string],
    no_rent_arrears_3 : [string],
    recommend_3 : [string],
    landlord_or_agent_name_4 : [string],
    rental_dates_4 : [string],
    rent_on_time_4 : [string],
    property_in_good_condition_4 : [string],
    no_rent_arrears_4 : [string],
    recommend_4 : [string],
    landlord_or_agent_name_5 : [string],
    rental_dates_5 : [string],
    rent_on_time_5 : [string],
    property_in_good_condition_5 : [string],
    no_rent_arrears_5 : [string],
    recommend_5 : [string],
    aml : [string],
    sanctions : [string],
    pep : [string],
    rca : [string],
    sip : [string],
    ool : [string],
    pdf_url : [string]
}
Result API Response Data Params Example
{
   "request_id":"3d51225d80",
   "branch_id":"71",
   "address":"32 London Bridge Street, London, SE1 9SG",
   "processed_date":"25/09/2018",
   "combined":"true",
   "rent_upfront":"false",
   "rent_amount":"£2,000",
   "affordability":"£2450",
   "profile_link":"https://www.rentprofile.co/r/examplerenter",
   "name":"Anna Stevens",
   "email_address":"example@renter.com",
   "mobile":"0712345****",
   "status":"Complete",
   "thumbnail":"https://s3-eu-west-1.amazonaws.com/rentprofile/tenantprofile/profile/eugyih/eugyih.jpg",
   "ccj":"pass",
   "bankruptcy":"pass",
   "credit_file_adverse_findings":"pass",
   "identity":"pass",
   "pets":"false",
   "dependents":"false",
   "right_to_rent":"true",
   "employment_type":"Employed",
   "employment_term":"Permanent",
   "employer":"Gulbenkian Andonian Solicitors",
   "job_title":"Trainee Solicitor",
   "position":"Full-time",
   "probation":"No",
   "start_month":"May",
   "start_year":"2016",
   "workplace_manager_verified":"true",
   "salary":"£32,000",
   "uk_bank_account":"true",
   "risk_score":"Low Risk",
   "renter_or_guarantor":"renter",
   "not_provided":"false",
   "first_rental":"false",
   "landlord_or_agent_name":"Michael T",
   "rental_dates":"July 2018 until January 2019",
   "rent_on_time":"true",
   "property_in_good_condition":"true",
   "no_rent_arrears":"true",
   "recommend":"true",
   "pdf_url":"https://rentprofile-reports.s3-eu-west-1.amazonaws.com/example/3d51225d80_examplerenter.pdf"
}

- The amount of months upfront will be in the response as months_upfront only if rent_upfront is true.
- Up to the most recent 5 previous agent/landlord recommendations will be provided in the response. If there are 0 previous agent/landlord recommendations and the renter has declaired it is not their first rental then not_provided will be true.
- Only relevant employment details will be in the response e.g. if self-employed with a limited company then registered_since, strike_actions, business_ccj and director will be included.
- Ownership refers to property ownership and will only be in the response if it is verified as true.
- Access to the pdf_url respository will be locked down to the whitelisted IP address(es) provided the by the API user (the example above is set as public).
- Due to generating the latest PDF it may take up to 5 seconds for the document to be uploaded to the PDF url path.

Result API Endpoint

https://www.rentprofile.co/v1/api/result/request
Result API Request Example
$ curl -H "Content-Type: application/json" -X POST -d '{"request_id":"3d51225d80","pdf_required":"true","api_key":"replace_this_with_the_api_key"}' https://www.rentprofile.co/v1/api/result/request
Result API Response Example
{"request_id":"3d51225d80","branch_id":"71","address":"32 London Bridge Street, London, SE1 9SG","processed_date":"25/09/2018","combined":"true","rent_upfront":"false","rent_amount":"£2,000","affordability":"£2450","profile_link":"https://www.rentprofile.co/r/examplerenter","name":"Anna Stevens","email_address":"example@renter.com","mobile":"0712345****","status":"Complete","thumbnail":"https://s3-eu-west-1.amazonaws.com/rentprofile/tenantprofile/profile/eugyih/eugyih.jpg","ccj":"pass","bankruptcy":"pass","credit_file_adverse_findings":"pass","identity":"pass","pets":"false","dependents":"false","right_to_rent":"true","employment_type":"Employed","employment_term":"Permanent","employer":"Gulbenkian Andonian Solicitors","job_title":"Trainee Solicitor","position":"Full-time","probation":"No","start_month":"May","start_year":"2016","workplace_manager_verified":"true","salary":"£32,000","uk_bank_account":"true","risk_score":"Low Risk","renter_or_guarantor":"renter","not_provided":"false","first_rental":"false","landlord_or_agent_name":"Michael T","rental_dates":"July 2018 until January 2019","rent_on_time":"true","property_in_good_condition":"true","no_rent_arrears":"true","recommend":"true","pdf_url":"https://rentprofile-reports.s3-eu-west-1.amazonaws.com/example/3d51225d80_examplerenter.pdf"}

Result API Demo

You can use the request id 3d51225d80 to try the Result API. Optionally use true for PDF Required.




Landlord AML Check API

The Landlord AML Check API is used to request an Identity, Property Ownership, Selective Licensing and Anti Money Laundering (AML) check, a common need when adding a new landlord to an agency (UK bank check optional). The property ownership check includes properties located in England and Wales only.

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below.

  • "api_key"
  • "landlord_aml_id"
  • "pdf_report"
  • "first_name"
  • "last_name"
  • "country_of_residence"
  • "nationality"
  • "address1_line1"
  • "address1_postcode"
  • - then either the parameters listed below -
  • "dob"
  • "home_address_line1"
  • "home_address_postcode"
  • "account_number"
  • "sort_code"
  • - or the id_doc_url parameter below -
  • "id_doc_url"
  • - optional parameters listed below -
  • "business_country_of_registration"
  • "notes"
  • "address1_ltd_company_or_llp_name"
  • "address2_line1"
  • "address2_postcode"
  • "address2_ltd_company_or_llp_name"
  • "address3_line1"
  • "address3_postcode"
  • "address3_ltd_company_or_llp_name"
  • "address4_line1"
  • "address4_postcode"
  • "address4_ltd_company_or_llp_name"
  • "address5_line1"
  • "address5_postcode"
  • "address5_ltd_company_or_llp_name"
  • "confirmed_ownership_name_required"
  • "client_name"
  • "client_type"
  • "client_email"
  • "client_phone"

Note: Up to 5 rental properties can be added for the Landlord AML Check, if more than 5 it will be handled offline.

The "landlord_aml_id" is a unique static identifier (set by you) for each user you wish to run a Landlord AML Check on (note this ID should not dynamically change as each user should only be set one landlord_aml_id).

If the request has been made on behalf of a client then "client_name", "client_email", "client_phone", "client_type" (for example: "landlord" or "agent") can be optionally provided.

Landlord AML Check API Method

The request type is POST

Landlord AML Check API Data Params

Landlord AML Check API Request Data Param Types
{
    api_key : [string],
    landlord_aml_id : [string],
    pdf_report : [string],
    first_name : [string],
    last_name : [string],
    dob : [string],
    home_address_line1 : [string],
    home_address_postcode : [string],
    account_number : [string],
    sort_code : [string],
    country_of_residence : [string],
    nationality : [string],
    id_doc_url : [string],
    business_country_of_registration : [string],
    notes : [string],
    address1_line1 : [string],
    address1_postcode : [string],
    address1_ltd_company_or_llp_name : [string],
    address2_line1 : [string],
    address2_postcode : [string],
    address2_ltd_company_or_llp_name : [string],
    address3_line1 : [string],
    address3_postcode : [string],
    address3_ltd_company_or_llp_name : [string],
    address4_line1 : [string],
    address4_postcode : [string],
    address4_ltd_company_or_llp_name : [string],
    address5_line1 : [string],
    address5_postcode : [string],
    address5_ltd_company_or_llp_name : [string],
    confirmed_ownership_name_required : [string],
    client_name : [string],
    client_type : [string],
    client_email : [string],
    client_phone : [string]
}

Note: dob format is DD/MM/YYYY

Landlord AML Check API Request Data Params Example
{
    "api_key":"longrandomstringforapikey123456",
    "landlord_aml_id":"yfew6iug2nvta",
    "pdf_report":"false",
    "first_name":"John",
    "last_name":"Doe",
    "id_doc_url":"https://www.exampleurl.com/imagehostlocation/imageid",
    "country_of_residence":"England",
    "nationality":"United Kingdom",
    "address1_line1":"10 Oxford Street",
    "address1_postcode":"W1D 1AN",
    "address2_line1":"50 Cannon Street",
    "address2_postcode":"EC4N 6JJ"
}

- To request the name of the owner if it does not match the landlord details provided, set confirmed_ownership_name_required as "true".

Landlord AML Check API Response Data Param Types
{
    landlord_aml_id : [string],
    owner_status : [string],
    aml_status : [string],
    uk_bank_status : [string]
}

Note: uk_bank_status will only be returned if the account_number, sort_code, home_address_line1 and home_address_postcode is provided in the request.

Landlord AML Check API Response Data Params Example
{
   "landlord_aml_id":"yfew6iug2nvta",
   "owner_status":"pending",
   "aml_status":"pending"
}

Landlord AML Check API Endpoint

https://www.rentprofile.co/v1/api/landlord_aml/check
Landlord AML Check API Request Example
$ curl -H "Content-Type: application/json" -X POST -d '{"landlord_aml_id":"yfew6iug2nvta","api_key":"replace_this_with_the_api_key","pdf_report":"false","first_name":"John","last_name":"Doe","id_doc_url":"https://www.exampleurl.com/imagehostlocation/imageid","country_of_residence":"England","nationality":"United Kingdom","address1_line1":"10 Oxford Street","address1_postcode":"W1D 1AN","address2_line1":"50 Cannon Street","address2_postcode":"EC4N 6JJ"}' https://www.rentprofile.co/v1/api/landlord_aml/check
Landlord AML Check API Response Example
{"landlord_aml_id":"yfew6iug2nvta","owner_status":"pending","aml_status":"pending"}



Landlord AML Status API

The Landlord AML Status API is used to check the latest status/result of a Landlord AML check.

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below.

  • "api_key"
  • "landlord_aml_id"

The "landlord_aml_id" is the landlord_aml_id parameter passed through when using the Landlord AML Check. This is a unique static identifier (set by you) for each user you wish to run a Landlord AML Check on (note this ID should not dynamically change as each user should only be set one landlord_aml_id).

Landlord AML Status API Method

The request type is POST

Landlord AML Status API Data Params

Landlord AML Status API Request Data Param Types
{
    api_key : [string],
    landlord_aml_id : [string]
}
Landlord AML Status API Request Data Params Example
{
    "api_key":"longrandomstringforapikey123456",
    "landlord_aml_id":"yfew6iug2nvta"
}
Landlord AML Status API Response Data Param Types
{
    landlord_aml_id : [string],
    owner_status : [string],
    aml_status : [string],
    uk_bank_status : [string],
    pdf_report : [string],
    identity : [string],
    sanctions : [string],
    pep : [string],
    rca : [string],
    sip : [string],
    ool : [string],
    address_1_full : [string],
    address_1_ownership : [string],
    address_1_confirmed_ownership_name: [string],
    address_2_full : [string],
    address_2_ownership : [string],
    address_2_confirmed_ownership_name: [string],
    address_3_full : [string],
    address_3_ownership : [string],
    address_3_confirmed_ownership_name: [string],
    address_4_full : [string],
    address_4_ownership : [string]
    address_4_confirmed_ownership_name: [string],
    address_5_full : [string],
    address_5_ownership : [string],
    address_5_confirmed_ownership_name: [string]
}

pep - Politically Exposed Persons
rca - Relatives, Close Associates
sip - Special Interest Persons
ool - Other Official Lists

Note: uk_bank_status will only be returned if the account_number, sort_code, home_address_line1 and home_address_postcode is provided in the request.

Landlord AML Status API Response Data Params Example
{
   "landlord_aml_id":"yfew6iug2nvta",
   "owner_status":"pass",
   "aml_status":"pass",
   "identity":"pass",
   "sanctions":"pass",
   "pep":"pass",
   "rca":"pass",
   "sip":"pass",
   "ool":"pass",
   "address_1_full":"10 Oxford Street, Soho, London, W1D 1AN",
   "address_1_ownership":"true",
   "address_2_full":"50 Cannon Street, London, EC4N 6JJ",
   "address_2_ownership":"true"
}

Notes on responses:
owner_status responses can be "pending", "unclear document", "in progress", "pass" or "fail"
aml_status responses can be "pending", "unclear document", "in progress", "pass" or "fail"
if pdf_report is requested as "true" in the Landlord AML Check API the response can be "pending" or the url path to the pdf report
identity responses can be "unclear document", "pending", "pass" or "fail"
sanctions, pep, rca, sip and ool responses can be "pending", "not applicable", "pass" or "fail"
address_(number)_ownership responses can be "pending", "true" or "false"
404 Not Found if there is no matching request for the landlord_aml_id

Landlord AML Status API Endpoint

https://www.rentprofile.co/v1/api/landlord_aml/status
Landlord AML Status API Request Example
$ curl -H "Content-Type: application/json" -X POST -d '{"landlord_aml_id":"yfew6iug2nvta","api_key":"replace_this_with_the_api_key"}' https://www.rentprofile.co/v1/api/landlord_aml/status
Landlord AML Status API Response Example
{"landlord_aml_id":"yfew6iug2nvta","owner_status":"pass","aml_status":"pass","identity":"pass","sanctions":"pass","pep":"pass","rca":"pass","sip":"pass","ool":"pass","address_1_full":"10 Oxford Street, Soho, London, W1D 1AN","address_1_ownership":"true","address_2_full":"50 Cannon Street, London, EC4N 6JJ","address_2_ownership":"true"}



Create Tenancy API

The Create Tenancy API replicates the adding of a new tenancy for Onboarding in our Agent Dashboard.

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below you wish to check against.

  • "api_key"
  • "address_line1"
  • "postcode"
  • "total_rent"
  • "applicant_name"
  • "deposit"
  • "holding_deposit"
  • "tenancy_start_date"
  • "tenancy_term_months"
  • "landlord_name"
  • "landlord_email"
  • "landlord_home_address_line1"
  • "landlord_home_address_postcode"
  • - then at least one of these parameters listed below -
  • "applicant_email"
  • "applicant_mobile"
  • - optional parameters listed below -
  • "town"
  • "city"
  • "deposit_amount"
  • "holding_deposit_external"
  • "holding_deposit_amount"
  • "deposit_scheme"
  • "deposit_type"
  • "deposit_auto_registration"
  • "deposit_held_by"
  • "deposit_replacement"
  • "deposit_replacement_only"
  • "payment_ref"
  • "is_standing_order_required"
  • "rent_free_amount"
  • "rent_free_deducted_from"
  • "rent_payment_frequency"
  • "rent_due_date"
  • "rent_amount_period" - coming soon (currently monthly by default)
  • "has_rent_increase"
  • "rent_increase_amount"
  • "rent_increase_type"
  • "tenancy_end_date"
  • "default_custom_clause"
  • "additional_custom_clause"
  • "landlord_break_clause_months"
  • "landlord_break_clause_date"
  • "landlord_break_clause_annually" - coming soon
  • "landlord_break_clause_before_after" - coming soon
  • "tenant_break_clause_months"
  • "tenant_break_clause_date"
  • "tenant_break_clause_annually" - coming soon
  • "tenant_break_clause_before_after" - coming soon
  • "landlord_home_address_town"
  • "landlord_home_address_city"
  • "landlord_name_2"
  • "landlord_email_2"
  • "landlord_home_address_line1_2"
  • "landlord_home_address_postcode_2"
  • "landlord_home_address_town_2"
  • "landlord_home_address_city_2"
  • "landlord_as_signatory"
  • "agent_to_sign_on_behalf_of_landlord"
  • "let_only"
  • "let_only_bankholders_name"
  • "let_only_account_number"
  • "let_only_sort_code"
  • "renewal"
  • "permitted_occupier_name_1"
  • "permitted_occupier_email_1"
  • "permitted_occupier_mobile_1"
  • "permitted_occupier_1_over18"
  • "permitted_occupier_name_2"
  • "permitted_occupier_email_2"
  • "permitted_occupier_mobile_2"
  • "permitted_occupier_2_over18"
  • "permitted_occupier_name_3"
  • "permitted_occupier_email_3"
  • "permitted_occupier_mobile_3"
  • "permitted_occupier_3_over18"
  • "garden"
  • "garage"
  • "parking_space"
  • "parking_space_description" - coming soon
  • "storage_space" - coming soon
  • "storage_space_description" - coming soon
  • "pets"
  • "pet_description"
  • "smoking"
  • "gas"
  • "council_tax_included"
  • "tv_licence_included"
  • "gas_bill_included"
  • "water_bill_included"
  • "electricity_bill_included"
  • "phone_bill_included"
  • "broadband_bill_included"
  • "applicant_months_upfront"
  • "branch_id"
  • "branch_name"
  • "combined"
  • "rent_per_person"
  • "aml_required"
  • "client_name"
  • "client_type"
  • "client_email"
  • "client_phone"

Note: Up to 10 applicants can be invited at once, use the applicant_is_guarantor_for option if the applicant is a guarantor (this does not apply for the first applicant who is the lead renter by default).
If renters are paying rent upfront use the applicant_months_upfront params to provide the number of months.
For example "6" for 6 months rent upfront.

If you do not know the branch_id's for your agency you can use the branch_name param instead (the list of branch names are displayed in the agent dashboard).

If the request has been made on behalf of a client then "client_name", "client_email", "client_phone", "client_type" (for example: "landlord" or "agent") can be optionally provided.

To request AML (Anti Money Laundering) checks on the applicants set aml_required as "true"

Create Tenancy API Method

The request type is POST

Create Tenancy API Data Params

Create Tenancy API Request Data Param Types
{
    api_key : [string],
    branch_id : [string],
    branch_name : [string],
    address_line1 : [string],
    town : [string],
    city : [string],
    postcode : [string],
    combined : [string],
    total_rent : [string],
    rent_per_person : [string],
    aml_required : [string],
    deposit : [string],
    holding_deposit : [string],
    tenancy_start_date : [string],
    tenancy_term_months : [string],
    landlord_name : [string],
    landlord_email : [string],
    landlord_home_address_line1 : [string],
    landlord_home_address_postcode : [string],
    deposit_amount : [string],
    holding_deposit_external : [string],
    holding_deposit_amount : [string],
    deposit_scheme : [string],
    deposit_type : [string],
    deposit_auto_registration : [string],
    deposit_held_by : [string],
    deposit_replacement : [string],
    deposit_replacement_only : [string],
    payment_ref : [string],
    is_standing_order_required : [string],
    rent_free_amount : [string],
    rent_free_deducted_from : [string],
    rent_payment_frequency : [string],
    rent_due_date : [string],
    rent_amount_period : [string],
    has_rent_increase : [string],
    rent_increase_amount : [string],
    rent_increase_type : [string],
    tenancy_end_date : [string],
    default_custom_clause : [string],
    additional_custom_clause : [string],
    landlord_break_clause_months : [string],
    landlord_break_clause_date : [string],
    landlord_break_clause_annually : [string],
    landlord_break_clause_before_after : [string],                                     
    tenant_break_clause_months : [string],
    tenant_break_clause_date : [string],
    tenant_break_clause_annually : [string],
    tenant_break_clause_before_after : [string],
    landlord_home_address_town : [string],
    landlord_home_address_city : [string],
    landlord_name_2 : [string],
    landlord_email_2 : [string],
    landlord_home_address_line1_2 : [string],
    landlord_home_address_postcode_2 : [string],
    landlord_home_address_town_2 : [string],
    landlord_home_address_city_2 : [string],
    landlord_as_signatory : [string],
    agent_to_sign_on_behalf_of_landlord : [string],
    let_only : [string],
    let_only_bankholders_name : [string],
    let_only_account_number : [string],
    let_only_sort_code : [string],
    renewal : [string],
    garden : [string],
    garage : [string],
    parking_space : [string],
    parking_space_description : [string],
    storage_space : [string],
    storage_space_description : [string],
    pets : [string],
    pets_description : [string],
    smoking : [string],
    gas : [string],
    council_tax_included : [string],
    tv_licence_included : [string],
    gas_bill_included : [string],
    water_bill_included : [string],
    electricity_bill_included : [string],
    phone_bill_included : [string],
    broadband_bill_included : [string],
    applicant_name : [string],
    applicant_email : [string],
    applicant_mobile : [string],
    applicant_months_upfront : [string],
    applicant_name_2 : [string],
    applicant_email_2 : [string],
    applicant_mobile_2 : [string],
    applicant_is_guarantor_for_2 : [string],
    applicant_months_upfront_2 : [string],
    applicant_name_3 : [string],
    applicant_email_3 : [string],
    applicant_mobile_3 : [string],
    applicant_is_guarantor_for_3 : [string],
    applicant_months_upfront_3 : [string],
    applicant_name_4 : [string],
    applicant_email_4 : [string],
    applicant_mobile_4 : [string],
    applicant_is_guarantor_for_4 : [string],
    applicant_months_upfront_4 : [string],
    applicant_name_5 : [string],
    applicant_email_5 : [string],
    applicant_mobile_5 : [string],
    applicant_is_guarantor_for_5 : [string],
    applicant_months_upfront_5 : [string],
    applicant_name_6 : [string],
    applicant_email_6 : [string],
    applicant_mobile_6 : [string],
    applicant_is_guarantor_for_6 : [string],
    applicant_months_upfront_6 : [string],
    applicant_name_7 : [string],
    applicant_email_7 : [string],
    applicant_mobile_7 : [string],
    applicant_is_guarantor_for_7 : [string],
    applicant_months_upfront_7 : [string],
    applicant_name_8 : [string],
    applicant_email_8 : [string],
    applicant_mobile_8 : [string],
    applicant_is_guarantor_for_8 : [string],
    applicant_months_upfront_8 : [string],
    applicant_name_9 : [string],
    applicant_email_9 : [string],
    applicant_mobile_9 : [string],
    applicant_is_guarantor_for_9 : [string],
    applicant_months_upfront_9 : [string],
    applicant_name_10 : [string],
    applicant_email_10 : [string],
    applicant_mobile_10 : [string],
    applicant_is_guarantor_for_10 : [string],
    applicant_months_upfront_10 : [string],
    permitted_occupier_name_1 : [string],
    permitted_occupier_email_1 : [string],
    permitted_occupier_mobile_1 : [string],
    permitted_occupier_1_over18 : [string],
    permitted_occupier_name_2 : [string],
    permitted_occupier_email_2 : [string],
    permitted_occupier_mobile_2 : [string],
    permitted_occupier_2_over18 : [string],
    permitted_occupier_name_3 : [string],
    permitted_occupier_email_3 : [string],
    permitted_occupier_mobile_3 : [string],
    permitted_occupier_3_over18 : [string],
    client_name : [string],
    client_type : [string],
    client_email : [string],
    client_phone : [string]
}

Valid deposit_scheme permitted values are "tds", "mydeposits" and "dps".

Valid deposit_replacement permitted values are "reposit", "flatfair" and "zerodeposit".

Valid rent_payment_frequency permitted values are "weekly", "monthly" and "annually" (if no permitted rent_payment_frequency value is provided, monthly will be set by default).

Valid rent_increase_type permitted values are "£" and "%".

Valid rent_free_deducted_from permitted values are "1"and "2" for indicicating whether the rent free amount will be deducted from the 1st or 2nd rental payment (this only applies if the rent_free_amount is provided).

Create Tenancy API Request Data Params Example
{
    "api_key":"longrandomstringforapikey123456",
    "branch_id":"71",
    "address_line1":"32 London Bridge Street",
    "city":"London",
    "postcode":"SE1 9SG",
    "combined":"true",
    "total_rent":"£2000",
    "deposit":"true",
    "deposit_amount":"£500",
    "deposit_scheme":"tds"
    "deposit_type":"custodial",
    "deposit_auto_registration":"true",
    "holding_deposit":"true",
    "holding_deposit_amount":"£100",
    "tenancy_start_date":"18-07-2021",
    "tenancy_term_months":"12",
    "default_custom_clause":"true",
    "additional_custom_clause":"2. The Tenants agree to water the plants in the hallway at least once a week.\n3. The Tenants agree to use the recycling bins where applicable.",
    "landlord_name":"Michael Thompson",
    "landlord_email":"example@landlord.com",
    "landlord_home_address_line1":"10 Moseley Road",
    "landlord_home_address_town":"Hallow",
    "landlord_home_address_city":"Worcester",
    "landlord_home_address_postcode":"WR2 6NJ",
    "applicant_name":"Anna Stevens",
    "applicant_email":"example@renter.com",
    "applicant_mobile":"07123456789",
    "applicant_name_2":"Tom Smith",
    "applicant_email_2":"example2@renter.com",
    "applicant_name_3":"Jane Smith",
    "applicant_email_3":"example@guarantor.com",
    "applicant_mobile_3":"07987654321",
    "applicant_is_guarantor_for_3":"Tom Smith"
}

The first applicant will be set as the lead tenant, in this example the lead tenant is Anna Stevens.

The default custom clause is the same default clauses which display when creating a tenancy via the Onboarding in the agent dashboard (if you do not wish to include this text do not set default_clause as "true"). To provide custom clauses besides the default (added after the default_clause if set as "true") use the additional_custom_clause param.
A line break should be used between each clause number using "/n" as shown in the example above.

Create Tenancy API Response Data Param Types
{
    tenancy_id : [string],
    applicant_name : [string],
    request_id : [string],
    applicant_name_2 : [string],
    request_id_2 : [string],
    applicant_name_3 : [string],
    request_id_3 : [string],
    applicant_name_4 : [string],
    request_id_4 : [string],
    applicant_name_5 : [string],
    request_id_5 : [string],
    applicant_name_6 : [string],
    request_id_6 : [string],
    applicant_name_7 : [string],
    request_id_7 : [string],
    applicant_name_8 : [string],
    request_id_8 : [string],
    applicant_name_9 : [string],
    request_id_9 : [string],
    applicant_name_10 : [string],
    request_id_10 : [string]
}
Create Tenancy API Response Data Params Example
{
   "tenancy_id":"78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4",
   "applicant_name":"Anna Stevens",
   "request_id":"3d51225d80",
   "applicant_name_2":"Tom Smith",
   "request_id_2":"837y4uie34",
   "applicant_name_3":"Jane Smith",
   "request_id_3":"d4jvrow237"
}

Multiple Request ID's (request_id, request_id_2, request_id_3 etc.) will be in the response if multiple applicants are submitted at the same time.

Create Tenancy API Endpoint

https://www.rentprofile.co/v1/api/onboarding/tenancy/create
Create Tenancy API Request Example
curl -H "Content-Type: application/json" -X POST -d '{"branch_id":"71","address_line1":"32 London Bridge Street","city":"London","postcode":"SE1 9SG","combined":"true","total_rent":"£2000","deposit":"true","deposit_amount":"£500","deposit_scheme":"tds","deposit_type":"custodial","deposit_auto_registration":"true","holding_deposit":"true","holding_deposit_amount":"£100","tenancy_start_date":"18-07-2021","tenancy_term_months":"12","default_custom_clause":"true","additional_custom_clause":"2. The Tenants agree to water the plants in the hallway at least once a week.\n3. The Tenants agree to use the recycling bins where applicable.","landlord_name":"Michael Thompson","landlord_email":"example@landlord.com","landlord_home_address_line1":"10 Moseley Road","landlord_home_address_town":"Hallow","landlord_home_address_city":"Worcester","landlord_home_address_postcode":"WR2 6NJ","applicant_name":"Anna Stevens","applicant_email":"example@renter.com","applicant_mobile":"07123456789","applicant_name_2":"Tom Smith","applicant_email_2":"example2@renter.com","applicant_name_3":"Jane Smith","applicant_email_3":"example@guarantor.com","applicant_mobile_3":"07987654321","applicant_is_guarantor_for_3":"Tom Smith","api_key":"replace_this_with_the_api_key"}' https://www.rentprofile.co/v1/api/onboarding/tenancy/create
Create Tenancy API Response Example
{"tenancy_id":"78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4","applicant_name":"Anna Stevens","request_id":"3d51225d80","applicant_name_2":"Tom Smith","request_id_2":"837y4uie34","applicant_name_3":"Jane Smith","request_id_3":"d4jvrow237"}

Tenancy Status API

The Tenancy Status API replicates the status in our Agent Dashboard displaying the progress of an Onboarding Tenancy.

This is a post based json rest api, for it to work include the api key in the post request (you can apply for this here) as well as the parameters listed below.

  • "api_key"
  • "tenancy_id"
  • - optional parameters listed below -
  • "applicant_status_required"
  • "deposit_status_required"

Tenancy Status API Method

The request type is POST

Tenancy Status API Data Params

Tenancy Status API Request Data Param Types
{
    api_key : [string],
    tenancy_id : [string],
    applicant_status_required : [string],
    deposit_status_required : [string]
}
Tenancy Status API Request Data Params Example
{
    "api_key":"longrandomstringforapikey123456",
    "tenancy_id":"78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4",
    "applicant_status_required":"true",
    "deposit_status_required":"true"
}
Tenancy Status API Response Data Param Types
{
    tenancy_id : [string],
    tenancy_status : [string],
    tenancy_agreement : [string],
    energy_performance_certificate : [string],
    electrical_certificate : [string],
    gas_safety_certificate : [string],
    deposit_amount : [string],
    deposit_scheme : [string],
    deposit_type : [string],
    deposit_auto_registration : [string],
    deposit_reference : [string],
    deposit_status : [string],
    applicant_name : [string],
    applicant_request_id : [string],
    renter_or_guarantor : [string],
    applicant_status : [string],
    applicant_name_2 : [string],
    applicant_request_id_2 : [string],
    renter_or_guarantor_2 : [string],
    applicant_status_2 : [string],
    applicant_name_3 : [string],
    applicant_request_id_3 : [string],
    renter_or_guarantor_3 : [string],
    applicant_status_3 : [string],
    applicant_name_4 : [string],
    applicant_request_id_4 : [string],
    renter_or_guarantor_4 : [string],
    applicant_status_4 : [string],
    applicant_name_5 : [string],
    applicant_request_id_5 : [string],
    renter_or_guarantor_5 : [string],
    applicant_status_5 : [string],
    applicant_name_6 : [string],
    applicant_request_id_6 : [string],
    renter_or_guarantor_6 : [string],
    applicant_status_6 : [string],
    applicant_name_7 : [string],
    applicant_request_id_7 : [string],
    renter_or_guarantor_7 : [string],
    applicant_status_7 : [string],
    applicant_name_8 : [string],
    applicant_request_id_8 : [string],
    renter_or_guarantor_8 : [string],
    applicant_status_8 : [string],
    applicant_name_9 : [string],
    applicant_request_id_9 : [string],
    renter_or_guarantor_9 : [string],
    applicant_status_9 : [string],
    applicant_name_10 : [string],
    applicant_request_id_10 : [string],
    renter_or_guarantor_10 : [string]
}

The value returned for the tenancy_status will be one of the following (DD/MM/YYYY replaced with the appropriate date):
"Agency Terms", "Referencing Criteria", "Holding Deposit", "Referencing", "Referencing - Waiting on Permitted Occupier(s)", "Upload certificates", "Tenancy Agreement - Tenant(s) to sign agreement", "Tenancy Agreement - Landlord & Agent to sign agreement", "Tenancy Agreement - Agent to sign agreement on behalf of Landlord", "Tenancy Agreement - Landlord to sign agreement", "Tenancy Agreement - Agent to sign agreement", "Deposit & Initial Rent", "Confirm Deposit", "Register Deposit", "Initial Rent", "Confirm Initial Rent", "Waiting on Standing Order", "Starts DD/MM/YYYY", "Renews DD/MM/YYYY", "Ends DD/MM/YYYY"

The value returned for the deposit_status (only provided if deposit_status_required is "true") will be one of the following:
"Pending", "Complete"

The value returned for the applicant_status (only provided if applicant_status_required is "true") will be one of the following:
"Waiting for agency terms to be agreed", "Waiting for referencing criteria to be agreed", "Waiting for holding deposit to be paid", "Waiting on applicant", "Waiting on co-applicants", "In review", "Waiting on refs & ID", "Waiting on references", "Waiting on landlord ref & ID", "Waiting on workplace ref & ID", "Waiting on earnings & ID", "Waiting on landlord reference", "Waiting on workplace reference", "Waiting on earnings", "Waiting on ID", "Processing", "Waiting for tenancy agreement to be signed", "Waiting for deposit to be paid", "Waiting for initial rent to be paid", "Completed the Onboarding process"

Tenancy Status API Response Data Params Example
{
   "tenancy_id":"78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4",
   "tenancy_status":"Starts 15/01/2022",
   "tenancy_agreement":"https://rentprofile.s3.eu-west-1.amazonaws.com/example/tenancy_agreement/78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4/78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4.pdf",
   "energy_performance_certificate":"https://rentprofile.s3-eu-west-1.amazonaws.com/prop/100/energy_certificate/f799bbcc17ba767f51b91a9d26b01138d7f3056fcc694c181b173d4677ef77f9532def12e9a65ab224b6edccc1d91a.jpg",
   "electrical_certificate":"https://rentprofile.s3-eu-west-1.amazonaws.com/prop/100/electrical_certificate/a06e3123411b28034b3304e55c202e0026edc56b530744b4d13956730aaf06a3e9c9c5c2776895971f481e291f67b3.pdf",
   "deposit_amount":"199.99",
   "deposit_scheme":"mydeposits",
   "deposit_type":"custodial",
   "deposit_auto_registration":"true",
   "deposit_reference":"123456789",
   "deposit_status":"complete"
   "applicant_name":"Anna Stevens",
   "applicant_request_id":"3d51225d80",
   "renter_or_guarantor":"renter",
   "applicant_status":"Completed the Onboarding process",
   "applicant_name_2":"Tom Smith",
   "applicant_request_id_2":"837y4uie34",
   "renter_or_guarantor_2":"renter",
   "applicant_status_2":"Completed the Onboarding process",
   "applicant_name_3":"Jane Smith",
   "applicant_request_id_3":"d4jvrow237",
   "renter_or_guarantor_3":"guarantor",
   "applicant_status_3":"Completed the Onboarding process"
}

If applicable the energy_performance_certificate, electrical_certificate and gas_safety_certificate will be in the response.

Tenancy Status API Endpoint

https://www.rentprofile.co/v1/api/onboarding/tenancy/status
Tenancy Status API Request Example
curl -H "Content-Type: application/json" -X POST -d '{"tenancy_id":"78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4","applicant_status_required":"true","deposit_status_required":"true","api_key":"replace_this_with_the_api_key"}' https://www.rentprofile.co/v1/api/onboarding/tenancy/status
Tenancy Status API Response Example
{"tenancy_id":"78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4","tenancy_status":"Starts 15/01/2022","tenancy_agreement":"https://rentprofile.s3.eu-west-1.amazonaws.com/example/tenancy_agreement/78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4/78e58eea6c5549adeb8e50d7c406572de549cc7b6c9bd48d4af1e2b627f4.pdf","energy_performance_certificate":"https://rentprofile.s3-eu-west-1.amazonaws.com/prop/100/energy_certificate/f799bbcc17ba767f51b91a9d26b01138d7f3056fcc694c181b173d4677ef77f9532def12e9a65ab224b6edccc1d91a.jpg","electrical_certificate":"https://rentprofile.s3-eu-west-1.amazonaws.com/prop/100/electrical_certificate/a06e3123411b28034b3304e55c202e0026edc56b530744b4d13956730aaf06a3e9c9c5c2776895971f481e291f67b3.pdf","deposit_amount":"199.99","deposit_scheme":"mydeposits","deposit_type":"custodial","deposit_auto_registration":"true","deposit_reference":"123456789","deposit_status":"complete""applicant_name":"Anna Stevens","applicant_request_id":"3d51225d80","renter_or_guarantor":"renter","applicant_status":"Completed the Onboarding process","applicant_name_2":"Tom Smith","applicant_request_id_2":"837y4uie34","renter_or_guarantor_2":"renter","applicant_status_2":"Completed the Onboarding process","applicant_name_3":"Jane Smith","applicant_request_id_3":"d4jvrow237","renter_or_guarantor_3":"guarantor","applicant_status_3":"Completed the Onboarding process"}