FOR AI AGENTS

Book a verified contractor ??? programmatically

Contractor Finder lets AI agents submit home-improvement job requests across Canada on behalf of users. We match a vetted contractor and follow up to confirm. Open API, no account required.

Submitting a request is not an instant confirmed booking. A human coordinator matches a verified pro (usually within 1 business day) and confirms date & quote with the contact you provide. Always include an email or phone.

Discovery

GEThttps://contractor-finder.ca/llms.txt

GEThttps://contractor-finder.ca/.well-known/agent-booking.json ??? capability manifest

GEThttps://contractor-finder.ca/api/agent/services ??? valid services, cities, time windows

Submit a job request

POSThttps://contractor-finder.ca/api/agent/book

JSON body. service, city, and a contact (email or phone) are required.

Field	Type	Notes
service required	string	e.g. roofing, windows, bathroom-renovation
city required	string	Any city or town in Canada
contact required	object	name, email, phone ??? at least email or phone
preferred_date	string	YYYY-MM-DD
preferred_time	string	morning ?? afternoon ?? evening ?? flexible ?? HH:MM
budget_cad	number	Approximate budget in CAD
description	string	Job details, free text
agent	object	name, on_behalf_of ??? who is calling

Example

POST https://contractor-finder.ca/api/agent/book
Content-Type: application/json

{
  "service": "roofing",
  "city": "Vaughan",
  "preferred_date": "2026-07-15",
  "preferred_time": "morning",
  "budget_cad": 6000,
  "description": "Replace asphalt shingles on a 2-storey detached home, ~1800 sq ft roof.",
  "contact": { "name": "Jane D.", "email": "jane@example.com", "phone": "416-555-0199" },
  "agent": { "name": "ExampleAssistant", "on_behalf_of": "Jane D." }
}

Response

{
  "status": "received",
  "reference": "CF-AGT-1A2B3C4D",
  "message": "Job request received. A vetted contractor will be matched and we'll follow up to confirm.",
  "next_steps": "A human coordinator assigns a verified pro, typically within 1 business day."
}

Coverage: contractors across Canada. Questions: contractor-finder.ca