List Instant Design Leads

Overview

The List Instant Design Leads endpoint retrieves lead information submitted through Instant Design lead forms associated with the authenticated Hover organization. This endpoint is typically used to access customer contact information and details submitted by prospective clients.

Each returned lead includes identifying information such as the full name, email, phone number, and location details (address, city, state, and postal code), along with the timestamp of when the lead was created. Pagination metadata is also included to support fetching results across multiple pages if necessary.

Sample Response Body

{
    "leads": [
        {
            "id": 106834,
            "email": "[email protected]",
            "phone_number": "+17758675309",
            "full_name": "Michael Bluth",
            "location_postal_code": "93420",
            "created_at": "2025-07-18T18:10:23.946Z",
            "location_line_1": "1019 Sunset Drive",
            "location_city": "Arroyo Grande",
            "location_region": "CA"
        },
        {
            "id": 105750,
            "email": "[email protected]",
            "phone_number": "+17155555555",
            "full_name": "Gob Bluth",
            "location_postal_code": "54481",
            "created_at": "2025-07-16T14:15:11.140Z",
            "location_line_1": "1808 April Lane",
            "location_city": "Stevens Point",
            "location_region": "CA"
        }
    ],
    "meta": {
        "pagination": {
            "total": 2,
            "total_count": 2,
            "current_page": 1,
            "next_page": null,
            "prev_page": null,
            "total_pages": 1
        }
    }
}