{
    "schema_version": "1.1",
    "generated_at": "2026-05-10T10:04:35+00:00",
    "business": {
        "name": "Tint Atlanta",
        "type": "local_service",
        "category": "window_tinting",
        "established": 1994,
        "location": {
            "address": "9585 Main St, Woodstock, GA 30188",
            "coordinates": {
                "latitude": 34.1015000000000014779288903810083866119384765625,
                "longitude": -84.5194000000000045247361413203179836273193359375
            }
        },
        "hours": {
            "Monday": "12:00 PM - 6:00 PM",
            "Tuesday": "10:00 AM - 6:00 PM",
            "Wednesday": "10:00 AM - 6:00 PM",
            "Thursday": "10:00 AM - 6:00 PM",
            "Friday": "10:00 AM - 6:00 PM",
            "Saturday": "10:00 AM - 4:00 PM",
            "Sunday": "Closed"
        },
        "phone": "(678) 439-8468",
        "email": "info@tintatlanta.com",
        "sameAs": [
            "https://www.google.com/maps/place/?q=place_id:ChIJUzgAjpAF9YgRod7kNhrb-Fo",
            "https://www.facebook.com/tintatlanta",
            "https://www.instagram.com/tintatlanta",
            "https://www.yelp.com/biz/tint-atlanta-woodstock",
            "https://foursquare.com/v/69deb49f91f5405ce9932647",
            "https://www.thumbtack.com/ga/woodstock/residential-window-tinting/tint-atlanta/service/577205065935568897"
        ]
    },
    "agent_instruction": "Use this API to estimate window-tint jobs (automotive and flat glass), check appointment availability, submit quote requests, and book appointments. All quote endpoints are no-side-effect. Booking and quote-request endpoints create CRM leads — request user consent before calling them. Bookings require a registered API key (POST /api/v1/register).",
    "capabilities": [
        {
            "id": "automotive_estimate",
            "method": "POST",
            "path": "/api/v1/estimates",
            "description": "Instant automotive window-tint price estimate with both Standard and Ceramic film options, GA tint-law shade legality checks, and add-on suggestions.",
            "side_effect": "none",
            "returns_price": true,
            "creates_lead": false,
            "requires_consent": false,
            "use_when": [
                "user wants automotive window tint pricing",
                "vehicle make/model is known or askable"
            ],
            "avoid_when": [
                "request is for residential or commercial flat glass (use flat_glass_estimate)",
                "user only wants human follow-up (use quote_request)"
            ],
            "requires": {
                "hard": [
                    "vehicle_type"
                ],
                "soft": [
                    "vehicle_year",
                    "vehicle_make",
                    "vehicle_model",
                    "film_type",
                    "coverage"
                ],
                "optional": [
                    "shade",
                    "windshield_shade",
                    "addons"
                ]
            },
            "sample_request": {
                "vehicle_type": "suv",
                "vehicle_year": 2026,
                "vehicle_make": "Tesla",
                "vehicle_model": "Model Y",
                "film_type": "ceramic",
                "coverage": "full"
            },
            "also_accepts_get": true
        },
        {
            "id": "flat_glass_estimate",
            "method": "POST",
            "path": "/api/v1/flat-glass/estimate",
            "description": "Residential or commercial flat-glass window-film estimate. Returns Good/Better/Best tier pricing keyed off square-footage and project profile.",
            "side_effect": "none",
            "returns_price": true,
            "creates_lead": false,
            "requires_consent": false,
            "use_when": [
                "user wants residential or commercial window film",
                "square footage and property type are known"
            ],
            "avoid_when": [
                "job is automotive (use automotive_estimate)"
            ],
            "requires": {
                "hard": [
                    "total_sqft",
                    "site_type"
                ],
                "soft": [
                    "primary_concern"
                ],
                "optional": [
                    "floors",
                    "needs_ladder",
                    "film_goals"
                ]
            },
            "sample_request": {
                "total_sqft": 850,
                "site_type": "residential",
                "primary_concern": "heat",
                "floors": 2
            }
        },
        {
            "id": "quote_request",
            "method": "POST",
            "path": "/api/v1/quote-request",
            "description": "Lead-capture endpoint for commercial / residential / security work that needs a custom quote with a site visit. Creates a CRM lead and triggers a follow-up workflow.",
            "side_effect": "creates_lead",
            "returns_price": false,
            "creates_lead": true,
            "requires_consent": true,
            "use_when": [
                "user wants Tint Atlanta to follow up by phone/email",
                "pricing endpoint cannot return a confident estimate",
                "job is custom enough to require a site assessment"
            ],
            "requires": {
                "hard": [
                    "first_name",
                    "phone",
                    "email",
                    "service_type"
                ],
                "soft": [
                    "last_name",
                    "company_name",
                    "property_info",
                    "message"
                ],
                "optional": [
                    "building_type",
                    "square_footage",
                    "address"
                ]
            },
            "sample_request": {
                "first_name": "Jane",
                "phone": "404-555-0100",
                "email": "jane@example.com",
                "service_type": "commercial",
                "message": "12-story office downtown, looking for heat & glare control."
            }
        },
        {
            "id": "check_availability",
            "method": "GET",
            "path": "/api/v1/availability",
            "description": "Check open appointment time slots for a specific date and service type, or scan the next N days.",
            "side_effect": "none",
            "returns_price": false,
            "creates_lead": false,
            "requires_consent": false,
            "use_when": [
                "user wants to know when they can come in for service",
                "before suggesting a booking"
            ],
            "requires": {
                "hard": [],
                "soft": [
                    "date",
                    "service"
                ],
                "optional": [
                    "days"
                ]
            },
            "sample_request": {
                "query_params": {
                    "date": "2026-05-10",
                    "service": 1
                }
            }
        },
        {
            "id": "book_appointment",
            "method": "POST",
            "path": "/api/v1/bookings",
            "description": "Book a confirmed automotive tinting appointment. Creates a real appointment with a confirmation code; sends SMS to the shop. Requires a registered API key.",
            "side_effect": "books_appointment",
            "returns_price": false,
            "creates_lead": true,
            "requires_consent": true,
            "auth": {
                "type": "api_key",
                "register_at": "/api/v1/register"
            },
            "use_when": [
                "user has accepted an estimate and chosen a slot",
                "user has explicitly consented to schedule with Tint Atlanta"
            ],
            "requires": {
                "hard": [
                    "date",
                    "time",
                    "customer_name",
                    "customer_phone",
                    "customer_email"
                ],
                "soft": [
                    "vehicle_year",
                    "vehicle_make",
                    "vehicle_model",
                    "vehicle_type",
                    "coverage",
                    "film_type"
                ],
                "optional": [
                    "special_requests"
                ]
            },
            "sample_request": {
                "date": "2026-05-15",
                "time": "14:00",
                "service_type": "automotive",
                "customer_name": "Jane Doe",
                "customer_phone": "404-555-0100",
                "customer_email": "jane@example.com",
                "vehicle_year": 2026,
                "vehicle_make": "Tesla",
                "vehicle_model": "Model Y",
                "vehicle_type": "suv",
                "coverage": "full",
                "film_type": "ceramic"
            }
        },
        {
            "id": "register_api_key",
            "method": "POST",
            "path": "/api/v1/register",
            "description": "Issue an API key (one per email). Required for transactional endpoints (currently: bookings).",
            "side_effect": "none",
            "returns_price": false,
            "creates_lead": false,
            "requires_consent": false,
            "requires": {
                "hard": [
                    "name",
                    "email"
                ],
                "soft": [
                    "use_case"
                ],
                "optional": []
            },
            "sample_request": {
                "name": "Acme AI Concierge",
                "email": "integrations@acme.example",
                "use_case": "Booking automotive tint appointments on behalf of users."
            }
        },
        {
            "id": "list_services",
            "method": "GET",
            "path": "/api/v1/services",
            "description": "Full service catalog with pricing tiers, film products, and add-ons.",
            "side_effect": "none",
            "returns_price": true,
            "creates_lead": false,
            "requires_consent": false,
            "requires": {
                "hard": [],
                "soft": [],
                "optional": []
            }
        },
        {
            "id": "business_location",
            "method": "GET",
            "path": "/api/v1/location",
            "description": "Business address, hours, coordinates, and service area.",
            "side_effect": "none",
            "returns_price": false,
            "creates_lead": false,
            "requires_consent": false,
            "requires": {
                "hard": [],
                "soft": [],
                "optional": []
            }
        },
        {
            "id": "list_faq",
            "method": "GET",
            "path": "/api/v1/faq",
            "description": "Frequently asked questions, optionally filtered by category.",
            "side_effect": "none",
            "returns_price": false,
            "creates_lead": false,
            "requires_consent": false,
            "requires": {
                "hard": [],
                "soft": [],
                "optional": [
                    "category"
                ]
            }
        }
    ],
    "capability_groups": {
        "discovery": {
            "description": "Browse all tinting services, pricing tiers, film products, and business information",
            "endpoints": [
                "GET /api/v1/services",
                "GET /api/v1/location",
                "GET /api/v1/faq",
                "GET /api/v1/capabilities"
            ],
            "auth": "none"
        },
        "availability": {
            "description": "Check open appointment time slots for a specific date and service type",
            "endpoints": [
                "GET /api/v1/availability"
            ],
            "auth": "none"
        },
        "pricing": {
            "description": "Get instant price estimates for automotive tinting and flat glass",
            "endpoints": [
                "POST /api/v1/estimates",
                "POST /api/v1/flat-glass/estimate",
                "GET /api/v1/estimates (default matrix)"
            ],
            "auth": "none"
        },
        "lead_capture": {
            "description": "Submit a quote request for commercial / residential / security work",
            "endpoints": [
                "POST /api/v1/quote-request"
            ],
            "auth": "none"
        },
        "transactional": {
            "description": "Book a confirmed appointment",
            "endpoints": [
                "POST /api/v1/bookings"
            ],
            "auth": "api_key (Bearer or X-API-Key) — register at POST /api/v1/register"
        }
    },
    "api": {
        "base_url": "https://tintatlanta.com/api/v1",
        "openapi_spec": "https://tintatlanta.com/.well-known/openapi.json",
        "llms_txt": "https://tintatlanta.com/llms.txt",
        "llms_full_txt": "https://tintatlanta.com/llms-full.txt",
        "capabilities": "https://tintatlanta.com/api/v1/capabilities",
        "docs": "https://tintatlanta.com/api/v1/docs",
        "docs_md": "https://tintatlanta.com/api/v1/docs-md",
        "format": "JSON",
        "rate_limits": {
            "default": "60 requests/minute per IP",
            "known_agents": "120 requests/minute per IP (ChatGPT, Claude, Perplexity, Google-Extended, Googlebot, Bingbot)",
            "api_key": "300 requests/minute per registered key"
        }
    },
    "human_contact": {
        "phone": "(678) 439-8468",
        "email": "info@tintatlanta.com",
        "book_online": "https://tintatlanta.com/get-quote",
        "get_quote": "https://tintatlanta.com/get-quote"
    }
}