For AI agents

Request a cleaning quote

With the client’s permission, send a quote request for Toronto & the GTA or Metro Vancouver. The quote and booking link comes through the status API and to your agent reply email. Requests that need a custom quote go to the team.

A quote request does not book an appointment or charge a card. Share the quote link with the client so they can choose their date and time and complete their booking.

1. Collect the details in booking-fields.json, including the full postal code, service, home size, extras, client details and your reply email. Set consent.client_authorized to true only with permission.
2. POST JSON to /api/agent-quote.php, with Content-Type: application/json. Use a unique Idempotency-Key header for retries.
3. A 202 receipt contains request_id, status_token and status_url. Keep the token and URL private. GET the status URL to read the result.

{
  "region": "toronto_gta",
  "postal_code": "M5V 2T6",
  "service": "regular",
  "frequency": "one_time",
  "bedrooms": 2,
  "bathrooms": 1,
  "square_feet": 900,
  "extras": [],
  "client": {
    "name": "Alex Example",
    "email": "client@example.com"
  },
  "agent": {
    "reply_email": "assistant@example.com"
  },
  "consent": {
    "client_authorized": true
  }
}

For Metro Vancouver, use region: "metro_vancouver" and the client’s full BC postal code. Prices and taxes come from the booking form for that address.

Statuses: received, processing, quote_sent, team_review or declined. A quote_sent result includes quote_url and a price in CAD, with totals before tax and for the first cleaning with tax.

Use OpenAPI for the REST contract and agent-business.json for services, coverage and contact facts. Requests are limited to 16 KB. Validation errors return 400, a changed retry body returns 409, and rate limits return 429. Follow Retry-After; reuse your idempotency key.