Find providers and request quotes
request_quotesUse when a customer wants an agent to find and book a home-service contractor (plumber, HVAC, electrician, roofer, appliance repair, locksmith, garage door, pest control, handyman, house cleaning, or another trade) at an address in Canada or the United States. We contact multiple independent providers by email, SMS and phone, ask for price and availability, check the options with the customer, and coordinate the booking the customer approves. Human operators assist as needed. We aim to return viable options within one hour for urgent requests, but response time, quote count, price and availability are not guaranteed and may be slower where we have no pre-built provider shortlist. This call creates a service request; it does not confirm an appointment or authorize work. The customer chooses and pays the provider directly. Collect every required field from the customer first, including explicit consent to be contacted.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City or municipality where service is needed. | |
| No | |||
| phone | No | ||
| trade | Yes | Home-service trade. Use 'other' with trade_detail for anything not listed. | |
| region | Yes | Province or state code or name, for example 'ON' or 'Texas'. | |
| country | Yes | ||
| problem | Yes | What is needed or wrong, with relevant details. | |
| urgency | Yes | ||
| postal_code | No | Postal or ZIP code. | |
| contact_name | Yes | ||
| trade_detail | No | Required when trade is 'other': the kind of contractor needed. | |
| preferred_time | No | Preferred appointment window in local time. | |
| service_address | Yes | Full street address where service is needed. | |
| source_platform | No | Calling agent or platform, if known. | |
| consent_to_contact | Yes | Must be true. Allows us and prospective providers to contact the customer about this request. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | ||
| next_step | Yes | ||
| request_id | Yes | ||
| coverage_tier | Yes | ||
| target_response | Yes | ||
| target_response_guaranteed | Yes |