{
  "name": "Septic-Help.com",
  "version": "1.0",
  "description": "U.S. 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://septic-help.com",
  "documentation": {
    "llms_txt": "https://septic-help.com/llms.txt",
    "agents_md": "https://septic-help.com/agents.md",
    "openapi": "https://septic-help.com/openapi.json"
  },
  "capabilities": {
    "quote.submit": {
      "method": "POST",
      "url": "https://septic-help.com/api/v1/quotes",
      "content_type": "application/json",
      "human_fallback": "https://septic-help.com/quote",
      "consent_required": "User must explicitly agree to share name, email, phone (optional), and ZIP code for contractor matching.",
      "required_fields": [
        "consent",
        "zip",
        "service",
        "urgency",
        "name",
        "email"
      ],
      "optional_fields": [
        "property_type",
        "phone",
        "description",
        "vendor_slug",
        "agent_source"
      ],
      "honeypot_field": "website",
      "dry_run": {
        "query": "https://septic-help.com/api/v1/quotes?dry_run=true",
        "description": "Validate a payload without creating a quote record. Returns 200 with a preview of the normalized API payload."
      },
      "enums": {
        "service": [
          "pump-out",
          "emergency",
          "alarm",
          "wet-area",
          "inspection",
          "repair",
          "install",
          "other"
        ],
        "urgency": [
          "emergency",
          "week",
          "month",
          "flexible"
        ],
        "property_type": [
          "residential",
          "cottage",
          "commercial",
          "multifamily"
        ]
      },
      "field_labels": {
        "service": {
          "pump-out": "Pump-Out / Cleanout",
          "emergency": "Emergency Backup",
          "alarm": "Alarm Going Off",
          "wet-area": "Wet Area / Smell",
          "inspection": "Inspection (Sale/Purchase)",
          "repair": "Tank / Drainfield Repair",
          "install": "System Replacement / Install",
          "other": "Other Service"
        }
      },
      "example_request": {
        "consent": true,
        "zip": "28204",
        "service": "pump-out",
        "property_type": "residential",
        "urgency": "week",
        "name": "Jane Doe",
        "email": "jane@example.com",
        "phone": "(704) 555-0100",
        "description": "Tank is due for routine pumping.",
        "agent_source": "chatgpt"
      }
    }
  }
}