Installers

Overview

Installers are organized into contractor organizations that form partnerships with routing operators. The Installer.com platform manages the full contractor relationship — from partnership setup through dispatching, scheduling, and job completion.

Listing Installers

Use the List Installers endpoint to retrieve a paginated list of installers available to your organization. You can filter by profession, services offered, and geographic proximity.

Filtering by Location

Pass orderCoordinates to sort installers by proximity to a specific location. This is useful when you want to find the closest available installer for a job.

Filtering by Profession & Services

Use the professions and services query parameters to narrow results to installers with specific qualifications.

Contractor Partnerships

Before installers can receive orders, their contractor organization must have an active partnership with the routing operator.

Partnership Lifecycle

1. Invited — Partnership request sent to the contractor
2. Active — Contractor accepted, can receive dispatched orders
3. Suspended — Temporarily paused (no new dispatches)
4. Terminated — Partnership ended

Dispatching Orders to Installers

Once you've identified the right installer, dispatch orders to them using the Dispatch Order endpoint. This will route the order based on your organization's routing strategy.

You can also create orders with automatic dispatching by including routing information when using the Create Order endpoint.

Service Areas

Contractors operate within defined geographic service areas. When listing installers, results can be filtered and sorted by proximity to ensure you're dispatching to contractors who cover the relevant area.