{
  "name": "SepticHelp.ca",
  "version": "1.0",
  "description": "Canadian septic service directory and free quote matching. Agents may collect answers in conversation and submit via the quote API with explicit user consent.",
  "site": "https://septichelp.ca",
  "documentation": {
    "llms_txt": "https://septichelp.ca/llms.txt",
    "agents_md": "https://septichelp.ca/agents.md",
    "openapi": "https://septichelp.ca/openapi.json"
  },
  "capabilities": {
    "quote.submit": {
      "method": "POST",
      "url": "https://septichelp.ca/api/v1/quotes",
      "content_type": "application/json",
      "human_fallback": "https://septichelp.ca/quote",
      "consent_required": "User must explicitly agree to share name, phone, email, and property address for contractor matching.",
      "required_fields": [
        "consent",
        "issue_type",
        "system_type",
        "tank_access",
        "urgency",
        "name",
        "email",
        "phone",
        "address",
        "city",
        "province"
      ],
      "optional_fields": [
        "last_pumped",
        "occupants",
        "constraints",
        "postal_code",
        "details",
        "vendor_slug",
        "agent_source"
      ],
      "honeypot_field": "website",
      "enums": {
        "issue_type": [
          "pumpout",
          "backup",
          "alarm",
          "wetarea",
          "inspection",
          "replace",
          "repair",
          "other"
        ],
        "system_type": [
          "gravity",
          "pump",
          "advanced",
          "unknown"
        ],
        "tank_access": [
          "easy",
          "buried",
          "deck",
          "unknown"
        ],
        "urgency": [
          "emergency",
          "soon",
          "week",
          "flexible"
        ],
        "last_pumped": [
          "less1",
          "1-3",
          "3-5",
          "more5",
          "unknown"
        ],
        "occupants": [
          "1-2",
          "3-4",
          "5+",
          "cottage"
        ],
        "constraints": [
          "Waterfront property",
          "Steep driveway",
          "Tight access",
          "Near well"
        ]
      },
      "field_labels": {
        "issue_type": {
          "pumpout": "Pump-Out / Cleanout",
          "backup": "Emergency Backup",
          "alarm": "Alarm Going Off",
          "wetarea": "Wet Area / Smell",
          "inspection": "Inspection (Sale/Purchase)",
          "replace": "System Replacement",
          "repair": "Tank/Bed Repair",
          "other": "Other Service"
        }
      },
      "example_request": {
        "consent": true,
        "issue_type": "pumpout",
        "system_type": "gravity",
        "tank_access": "easy",
        "urgency": "week",
        "last_pumped": "3-5",
        "occupants": "3-4",
        "name": "Jane Doe",
        "email": "jane@example.com",
        "phone": "(403) 555-0100",
        "address": "123 Rural Road",
        "city": "Red Deer",
        "province": "Alberta",
        "postal_code": "T4N 1A1",
        "details": "Tank is due for routine pumping.",
        "agent_source": "chatgpt"
      }
    }
  }
}
