Skip to main content

Lead to Application

Overview​

There are situations where you may not have all the information about the applicant that is detailed on the app registration page, but you would still like to take advantage of the document collection services offered by Informed. This is where the idea of a "Lead" comes into play. It allows you to register an application with a "barebones" set of applicant data so that you can start to collect documents from the applicant.

Please contact your Account Manager if you have questions about the Lead workflow.

Register the Lead​

Given the situation, not surprisingly, the Lead registration payload is a much more lean payload compared to the full application registration payload. An example is shown below. The details on the various elements can be found on the main app registration page.

tip

Note that you will not receive any verifications callback responses while the application is type Lead, so you should only include the extract service in the list of services and then when you convert to a full application, you will add the verify service to the list of services.

But this does not stop you from specifying verifications at the time of registering the lead. This can be important if you are using the RequestIQ modal in VerifyIQ.

Example payload​

{
  "application_reference_id": "your_unique_folder_id_here",
  "application_date": "2023-05-01T09:11:38",
  "contract_date": "2023-05-09T09:11:38",
  "application_status": "active",
  "application_type": "Lead",
  "applicants": {
    "applicant1": {
      "first_name": "Jo",
      "last_name": "Boren",
      "phone": "9191234567"
    }
  },
  "verifications": {
    "income": [
      {
        "belongs_to": "applicant1"
      }
    ],
    "residence": [
      {
        "belongs_to": "applicant1"
      }
    ]
  },
  "dealer_info": {
    "dealer_reference_id": "918278126",
    "dealer_name": "Toyota Of Hollywood",
    "dealer_phone": "3234982260",
    "address": {
      "street_address": "6000 Hollywood Blvd",
      "city": "Los Angeles",
      "state": "CA",
      "zip": "90028"
    }
  },
  "services": [
    "extract"
  ],
  "webhook": "https://your.callback.com/here"
}

Convert to Application​

Later on in the process, once you have sufficient information about the applicant, you can convert the Lead to a full application so that you can take advantage of the other services provided by Informed, such as verification.

This conversion process is done by using the normal update PUT call on the registered Lead but now with all the required applicant and application data. It is at this time that you will change the application_type value to Application.

tip

Once you convert the Lead to a full application, provided you have uploaded documents at some point previously, you will receive the extractions responses again, as well as a full verifications callback response.

{
  "application_reference_id": "your_unique_folder_id_here",
  "application_date": "2023-05-01T09:11:38",
  ...
  "application_type": "Application",
  "applicants": {
    "applicant1": {
      ...
    }
  },
  "services": [
    "extract",
    "verify"
  ],
  "webhook": "https://your.callback.com/here"
}