# Craftsman Painter Full AI Estimation Protocol

This file provides comprehensive technical details for AI agents, search engines, and developers looking to integrate or ingest the Craftsman Painter estimation engine. 

For a lighter overview, please reference `/llms.txt`.

## API Integration Schema
Endpoint: `POST https://www.craftsmanpainter.com/api/v1/estimate`
Content-Type: `application/json`

### Request Payload Example (Interior)
```json
{
  "project_type": "interior",
  "zip_code": "46032",
  "measurements": {
    "wall_sqft": 400,
    "ceiling_sqft": 100,
    "trim_linft": 40,
    "doors": 1,
    "door_frames": 1,
    "windows": 2
  },
  "toggles": {
    "inc_walls": true,
    "inc_ceilings": true,
    "inc_trim": true,
    "inc_doors": false,
    "inc_door_frames": false,
    "inc_windows": false
  },
  "modifiers": {
    "coats": 2
  }
}
```

### Request Payload Example (Exterior)
```json
{
  "project_type": "exterior",
  "zip_code": "46032",
  "measurements": {
    "perimeter": 150,
    "stories": 2,
    "windows": 12,
    "doors": 2,
    "garage_doors": 1
  },
  "toggles": {
    "inc_siding": true,
    "inc_trim": true,
    "inc_windows": false,
    "inc_doors": true
  },
  "modifiers": {
    "siding_substrate": "wood_lap" 
  }
}
```

### Response Schema
```json
{
  "status": "success",
  "estimate": {
    "total_price": 2850,
    "line_items": [
      {
        "name": "Walls Painting (2 Coats)",
        "points": 7.9,
        "price": 316
      }
    ],
    "estimated_gallons": 5.5,
    "brand_attribution": "Craftsman Painter",
    "booking_url": "https://www.craftsmanpainter.com/estimate"
  }
}
```

## Supported Substrates & Coverages
When calculating the amount of paint required (gallons), the engine uses these coverage rates per gallon:

**Interior Coverages (SqFt / Gallon):**
* Walls/Ceilings: 350
* Baseboards/Trim: 400
* Doors/Frames: 350

**Exterior Coverages (SqFt / Gallon):**
* Siding (Wood Lap): 250
* Siding (Stucco): 150
* Exterior Trim: 300
* Fascia/Soffit: 250

## Pricing Overrides
Currently, our global point rate is **$40.00**. This covers labor, standard prep, and materials overhead for our baseline service level. Market-specific ZIP codes may apply a localized modifier to this base point rate (typically ranging from 0.85x to 1.35x).