POST /checkProgramAvailability

• Purpose: Determine whether the GLP-1 Weight-Loss Program is offered to a prospective patient.
• Auth: Authorization: Bearer <access_token>
• Content-Type: application/json
• Idempotent: Yes (same input ⇒ same outcome).

Request body schema

Field	Type	Required	Example	Notes
zipCode	string	Yes	"75035"	5-digit U.S. ZIP
insuranceType	string	Yes	"Commercial"	Enum: Commercial | Government | Medicare | Medicaid | SelfPay (confirm full list)

{
  "zipCode": "75035",
  "insuranceType": "Commercial"
}

Success response 200 OK — Program Available

{
    "data": {
        "cbos": [
            {
                "cboID": 1,
                "cbo_drugs": [
                    {
                        "cboDrugID": 1,
                        "cboID": 1,
                        "cboName": "Collin County Community Health Center",
                        "cboSubsidy": 2.0,
                        "cost": 20.0,
                        "description": "Used to lower cholesterol and reduce the risk of heart disease.",
                        "drugID": 1,
                        "drugName": "Atorvastatin (Lipitor)",
                        "manufacturerSubsidy": 2.0,
                        "status": "active"
                    },
                    {
                        "cboDrugID": 2,
                        "cboID": 1,
                        "cboName": "Collin County Community Health Center",
                        "cboSubsidy": 1.5,
                        "cost": 15.5,
                        "description": "Used to treat type 2 diabetes.",
                        "drugID": 2,
                        "drugName": "Metformin (Glucophage)",
                        "manufacturerSubsidy": 1.5,
                        "status": "active"
                    },
                    {
                        "cboDrugID": 3,
                        "cboID": 1,
                        "cboName": "Collin County Community Health Center",
                        "cboSubsidy": 1.2,
                        "cost": 12.0,
                        "description": "Used to treat high blood pressure and angina.",
                        "drugID": 3,
                        "drugName": "Amlodipine (Norvasc)",
                        "manufacturerSubsidy": 1.2,
                        "status": "active"
                    }
                ],
                "credentialedPrescriberNPIs": [
                    {
                        "NPI": "NPI002",
                        "name": "Jane Smith",
                        "prescriberID": 2
                    }
                ],
                "name": "Collin County Community Health Center",
                "pharmacies": [
                    {
                        "pharmacyID": 2,
                        "pharmacyName": "CHC Pharmacy 2"
                    },
                    {
                        "pharmacyID": 5,
                        "pharmacyName": "CHC Pharmacy 4"
                    }
                ]
            }
        ],
        "determinationReason": "Available",
        "eligible": true
    },
    "message": "Program is available",
    "success": true
}

Success response 200 OK — Program Unavailable due to Insurance Type

{
    "data": {
        "cbos": [],
        "eligible": false,
        "reason": "Unavailable due to insurance type"
    },
    "message": "Program is unavailable",
    "success": true
}

Success response 200 OK — Program Unavailable due to Zip Code

{
    "data": {
        "cbos": [],
        "eligible": false,
        "reason": "Unavailable due to zip code"
    },
    "message": "Program is unavailable",
    "success": true
}

Success response 200 OK — Program Unavailable due to BOTH Insurance Type and Zip Code

{
    "data": {
        "cbos": [],
        "eligible": false,
        "reason": "Unavailable due to zip code and Insurance Type"
    },
    "message": "Program is unavailable",
    "success": true
}

Error Responses for POST /checkProgramAvailability

400 Bad Request

This error occurs due to one or more required fields being missing or malformed

Example: Missing Zip Code

{
    "error": {
        "code": "BAD_REQUEST",
        "details": "Missing required fields: Patient Zip Code"
    },
    "message": "Bad request",
    "success": false
}

401 Unauthorized

This error occurs when there is a missing/invalid bearer token (see global Auth section).

404 Not Found

This error occurs when the endpoint path is incorrect and is presented as a standard 404 HTML/JSON response from the gateway.