{
  "openapi": "3.1.0",
  "info": {
    "title": "HI Information API",
    "version": "0.1.0",
    "description": "Practical-cost data intelligence API. v0 is a sandbox returning modeled estimates pending verified collection."
  },
  "servers": [
    {
      "url": "https://hiinformation.com"
    }
  ],
  "paths": {
    "/api/v1/cost/moving-estimate": {
      "get": {
        "operationId": "api.v1.cost.moving_estimate",
        "summary": "Estimate moving cost (low/median/high) by home size, distance, and metro.",
        "responses": {
          "200": {
            "description": "OK (sandbox / mock in v0)"
          }
        },
        "x-price-tier": "free",
        "x-mock": true,
        "x-status": "api_allowed",
        "x-datasets": [
          "dataset.us.moving_cost.v1"
        ],
        "x-formula": "formula.moving_cost.estimate.v1"
      }
    },
    "/api/v1/index/moving-cost": {
      "get": {
        "operationId": "api.v1.index.moving_cost",
        "summary": "HI Moving Cost Index — national median + metro index (US=100).",
        "responses": {
          "200": {
            "description": "OK (sandbox / mock in v0)"
          }
        },
        "x-price-tier": "free",
        "x-mock": true,
        "x-status": "api_allowed",
        "x-datasets": [
          "dataset.us.moving_cost.v1"
        ],
        "x-formula": null
      }
    },
    "/api/v1/formula/moving-cost": {
      "get": {
        "operationId": "api.v1.formula.moving_cost",
        "summary": "The versioned moving-cost formula, variables, and assumptions.",
        "responses": {
          "200": {
            "description": "OK (sandbox / mock in v0)"
          }
        },
        "x-price-tier": "free",
        "x-mock": true,
        "x-status": "api_allowed",
        "x-datasets": [],
        "x-formula": "formula.moving_cost.estimate.v1"
      }
    },
    "/api/v1/sources": {
      "get": {
        "operationId": "api.v1.sources",
        "summary": "Source reliability & freshness graph — authority, license, rights, cadence.",
        "responses": {
          "200": {
            "description": "OK (sandbox / mock in v0)"
          }
        },
        "x-price-tier": "starter",
        "x-mock": true,
        "x-status": "api_allowed",
        "x-datasets": [],
        "x-formula": null
      }
    },
    "/api/v1/methodology": {
      "get": {
        "operationId": "api.v1.methodology",
        "summary": "Published methodologies with sources, assumptions, and limitations.",
        "responses": {
          "200": {
            "description": "OK (sandbox / mock in v0)"
          }
        },
        "x-price-tier": "free",
        "x-mock": true,
        "x-status": "api_allowed",
        "x-datasets": [],
        "x-formula": null
      }
    },
    "/api/v1/cost/home-project-estimate": {
      "get": {
        "operationId": "api.v1.cost.home_project_estimate",
        "summary": "Estimate home-project cost (e.g. interior painting) by area and region.",
        "responses": {
          "200": {
            "description": "OK (sandbox / mock in v0)"
          }
        },
        "x-price-tier": "starter",
        "x-mock": true,
        "x-status": "rights_pending",
        "x-datasets": [
          "dataset.us.local_service_cost.v1"
        ],
        "x-formula": "formula.home_project.interior_painting.v1"
      }
    },
    "/api/v1/electricity/prices": {
      "get": {
        "operationId": "api.v1.electricity.prices",
        "summary": "US electricity rates (cents/kWh) by state & sector — JSON/CSV. Real EIA data, LIVE (Cloudflare Function).",
        "responses": {
          "200": {
            "description": "OK (sandbox / mock in v0)"
          }
        },
        "x-price-tier": "free",
        "x-mock": false,
        "x-status": "published",
        "x-datasets": [
          "dataset.us.electricity_price.v1"
        ],
        "x-formula": null
      }
    }
  }
}