Inspection Checklists

What is an Inspection Checklist?

• The Inspection Checklist is a customized digital questionnaire form that allows you to gather important insight
• Choose from different question types: numeric questions, yes/no questions, and open ended text questions
• There’s no limit to the number of questions you can include (however we do recommend 20 questions or less if you’re planning on having the insured answer the questions)

Inspection Checklist for Integrated Workflows

What You Need To Know

1. We recommend updating your integrations to recognize the full value of HOVER's Inspection Checklist functionality
2. Updating your integration allows you to capture the questions and answers to your questionnaire form and
   send that information to your downstream systems that need it.
3. If you decide not to update your integration, your team will still be able to use the new
   Inspection Checklist feature. However, depending on your workflow and implementation, you may find
   more value in capturing this information programmatically in order to automate your workflows.

Using the Inspection Checklist API

The Inspection Checklist API is a simple GET request to our endpoint, scoped to a specific property and organization. Here's a sample request:

GET https://hover.to/api/inspection/checklists/latest?job_id=54321&org_id=44665

Note: The job_id and org_id parameters are required in this request.

Here is a sample response body (with a few question/answer objects truncated):

{
    "id": "3f820ca2-90e6-4780-b507-333c1d2fdebf",
    "job_id": 7270589,
    "questions": [
        {
            "id": "469e1f46-e2fd-4284-b70d-c8929f29b4e4",
            "sort_order": 0,
            "question_type": "boolean",
            "question_text": "Is there a satellite dish?",
            "answer_value": true,
            "images": []
        },
        {
            "id": "098f5a83-0f2b-4d2b-8d3f-bbeef1958c76",
            "sort_order": 1,
            "question_type": "boolean,
            "question_text": "Reinstall satellite dish?",
            "answer_value": false,
            "images": []
        },
      ...
      ]
        "report_pdf": {
        "id": 183897,
        "name": "report_pdf",
        "record_id": "3f820ca2-90e6-4780-b507-333c1d2fdebf",
        "record_type": "Inspection::Checklist",
        "blob_id": 184123,
        "created_at": "2023-10-11T18:10:40.695Z",
        "pdf_url": "http://ehi.hover.to/rails/active_storage/blobs/redirect/eyJfcmFpbHMdf8e8b88184c1cf0092d500b3cd2ce94917c/7270589_checklist_report.pdf"
    }
}

In addition to questions and answers, the response payload will include a link to the Inspection Checklist PDF (the pdf_url field above), which can then be imported into any system of your choosing.

For more information on this endpoint, please refer to our reference documentation.

Webhook Events

Two additional webhook events have been created so you can be notified of when a checklist has been created or updated for a given project.

These event names are: inspection_checklist_created and inspection_checklist_updated. For more information on these events, including sample payloads, please refer to our Webhooks reference.

Example Workflow

We would expect most integrations using the Inspection Checklist to have a workflow similar to this:

1. Create a Capture Request or Job
2. A HOVER user captures the property
3. Webhook notifications alert your integration when the project and subsequent Inspection Checklists have been completed for that job
4. You utilize the data from those webhook payloads to import deliverables (raw measurement data, measurement PDF, etc.) and now, the Inspection Checklist results, into the system(s) of your choosing!