{
  "ok": true,
  "shop": {
    "id": "demo-plumbing",
    "name": "Demo Plumbing Co.",
    "trade": "Plumber",
    "area": "Round Rock, TX (made-up demo shop)",
    "phone": "(512) 555-0142",
    "hours": "Mon-Sat 7 am - 6 pm",
    "services": [
      "Water heater repair",
      "Leak repair",
      "Drain cleaning",
      "Toilet repair",
      "Other"
    ],
    "demo": true
  },
  "how_to_book": "POST JSON to https://fiftyasks.com/api/shops/demo-plumbing/requests. This sends the shop a visit request; it is not a booked appointment until the shop confirms a time (status \"confirmed\").",
  "fields": {
    "problem": "required: what needs fixing",
    "contact_name": "required: the person the visit is for",
    "phone": "required: the shop confirms by phone or text",
    "address": "required: job address, or at least ZIP",
    "preferred_times": "required: e.g. \"Thursday morning\"",
    "service": "optional: one of services",
    "email": "optional",
    "notes": "optional",
    "agent_name": "optional: which agent you are",
    "booked_by": "\"agent\" or \"person\""
  },
  "other_doors": {
    "browser_form": "https://fiftyasks.com/b/demo-plumbing",
    "get_only": "GET https://fiftyasks.com/api/shops/demo-plumbing/requests?problem=...&contact_name=...&phone=...&address=...&preferred_times=... returns a confirm_url; a GET on it sends the request",
    "mcp": "https://fiftyasks.com/mcp (tools get_shop, request_visit, get_visit_request)"
  },
  "statuses": {
    "requested": "sent to the shop, not booked",
    "confirmed": "the shop confirmed; confirmed_time says when",
    "declined": "the shop cannot take it",
    "cancelled": "withdrawn by the requester"
  },
  "deterrents": "Only spambot deterrents: no CAPTCHA, no login. Agents are welcome.",
  "booking_service": "Fifty Asks (fiftyasks.com)"
}