{
  "openapi": "3.0.3",
  "info": {
    "title": "Lower My Bill",
    "version": "1.0.0",
    "description": "Ready-to-use call scripts for lowering US household bills: home internet, mobile, cable or satellite TV, car and home insurance, electricity, credit card interest and gym memberships, with tips for Xfinity (Comcast), Spectrum, AT&T, Verizon, T-Mobile, Cox, Optimum, DIRECTV, DISH, GEICO, Progressive, State Farm and Allstate. Each script says who to ask for (retention or loyalty), what to say, which offers to ask for and when to be ready to switch. Also lists official help programmes with links: Lifeline, LIHEAP, weatherization, and provider low-cost internet plans (Xfinity Internet Essentials, Spectrum Internet Assist, Access from AT&T, Verizon Forward). The ACP ended in 2024 and is never offered as available. Every answer has a ready-to-read `say` line. Scripts are for the user to use themselves; nothing is called, switched or changed. Read only, no account, nothing stored. Programmes checked on official pages on 27 September 2026.",
    "contact": { "email": "hello@askmizan.com" }
  },
  "servers": [{ "url": "https://lowermybill.pages.dev" }],
  "paths": {
    "/v1/script": { "get": { "operationId": "getBillScript", "summary": "A call script to lower a bill", "description": "Use for \"help me lower my Comcast bill\", \"script to get a better phone plan\", \"how do I negotiate my car insurance?\", \"lower my credit card interest\". Give the bill type, the provider, or both.", "parameters": [ { "name": "bill", "in": "query", "required": false, "description": "internet, mobile, tv, car insurance, home insurance, electricity, credit card or gym. Up to 60 characters.", "schema": { "type": "string", "example": "internet" } }, { "name": "provider", "in": "query", "required": false, "description": "Company name, for example Comcast, Xfinity, Spectrum, AT&T, Verizon, T-Mobile, Cox, Optimum, DIRECTV, DISH, GEICO, Progressive, State Farm, Allstate. Up to 60 characters.", "schema": { "type": "string", "example": "Comcast" } } ], "responses": { "200": { "description": "Script" }, "400": { "description": "Neither bill nor provider given" }, "404": { "description": "Bill type or provider not recognised" } } } },
    "/v1/help": { "get": { "operationId": "getBillHelp", "summary": "Official help programmes for a bill", "description": "Use for \"is there help paying my internet bill?\", \"help with my electric bill\", \"cheap internet for low income\", \"does Xfinity have a low-income plan?\". Returns programmes with who qualifies and how to apply.", "parameters": [ { "name": "bill", "in": "query", "required": true, "description": "internet, mobile, electricity (or heating, gas), tv, car insurance, home insurance, credit card, or a provider name. Up to 60 characters.", "schema": { "type": "string", "example": "internet" } } ], "responses": { "200": { "description": "Programmes" }, "400": { "description": "Bill missing" }, "404": { "description": "Bill type not recognised" } } } },
    "/v1/health": { "get": { "operationId": "health", "summary": "Service status", "description": "Liveness check. Not for user questions.", "responses": { "200": { "description": "OK" } } } }
  }
}