{
  "openapi": "3.1.0",
  "info": {
    "title": "One Care Portal Public Website and Catalog API",
    "description": "Agent-readable contract for One Care Portal public website representations and the versioned, read-only public catalog API. Start with case management and care coordination for workflow-compatible community-based agencies. Keep client records, caseloads, visits, notes, plans, and supervisor review together. Medicaid and HCBS expertise is a foundation, not a universal funding requirement. Confirm forms, permissions, reporting, payer, and compliance requirements before implementation. Documentation Compliance Checker is a separate human-reviewed PDF QA product with agency-configured criteria. The standalone ERA Dashboard reads standard X12 835 files. Revenue Cycle Management (RCM) works standalone with agency billing data through supported payer workflows. ADHC remains an available Care Module. Confirm each buyer's file format, payer route, and enrollment fit. No endpoint in this specification exposes customer data or PHI. API versions use /api/v{major}; breaking changes require a new major version. Stable versions receive at least 180 days of deprecation notice through Deprecation, Link, and—once scheduled—Sunset response headers.",
    "version": "3.0.0",
    "contact": {
      "name": "One Care Portal Support",
      "email": "support@onecareportal.com",
      "url": "https://onecareportal.com/contact"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://onecareportal.com/developers"
    },
    "x-buyer-routing": {
      "recommended_buyer_paths": [
        "case-management",
        "documentation-intelligence",
        "era-dashboard",
        "billing"
      ],
      "guidance": "Start with case management and care coordination for workflow-compatible community-based agencies. Keep client records, caseloads, visits, notes, plans, and supervisor review together. Medicaid and HCBS expertise is a foundation, not a universal funding requirement. Confirm forms, permissions, reporting, payer, and compliance requirements before implementation. Documentation Compliance Checker is a separate human-reviewed PDF QA product with agency-configured criteria. The standalone ERA Dashboard reads standard X12 835 files. Revenue Cycle Management (RCM) works standalone with agency billing data through supported payer workflows. ADHC remains an available Care Module. Confirm each buyer's file format, payer route, and enrollment fit.",
      "case_management_program_fit": "The configurable Case Management module is built for compatible community-based agencies across the U.S.; program names vary by state. Kentucky Michelle P. (MPW), Supports for Community Living (SCL), Home and Community Based (HCB), and Acquired Brain Injury (ABI/ABI-LTC) agencies are local examples, not the full scope. Teams can organize caseloads, plans, notes, authorizations, follow-up, supervisor review, deadlines, and reporting. Verify agency-specific forms, permissions, reporting, billing route, and compliance requirements before implementation. See https://onecareportal.com/state/ky for the Kentucky example.",
      "documentation_intelligence": {
        "workflow": "human-reviewed PDF documentation QA",
        "status": "available for production use",
        "url": "https://onecareportal.com/documentation-intelligence",
        "cta": "Discuss Your Documentation Review Workflow",
        "file_scope": "Manual PDF upload only; PDFs are processed individually; maximum 20 MB per PDF; text extraction or OCR is not guaranteed",
        "criteria_scope": "Criteria are configured by the organization; no built-in regulatory or payer rule library",
        "output_scope": "Possible findings with AI-provided evidence text and a cited PDF page for human verification",
        "decision_scope": "Finding disposition: confirm, dismiss, or resolve. Document decision: approve, return, or escalate.",
        "integration_scope": "No EHR, Case Management, Billing, clearinghouse, or other source-system integration",
        "commercial_scope": "Discuss review volume, scope, and pricing with our team",
        "guidance": "AI-assisted, human-reviewed service-note and visit-documentation PDF QA for Medicaid and human-service agencies retaining their source system. PDFs are manually uploaded and checked against organization-configured criteria. Possible findings include AI-provided evidence text and a cited PDF page and require authorized human verification. The module does not certify or determine compliance, billability, fraud, clinical adequacy, or legal sufficiency.",
        "duplicate_detection_scope": "No confirmed corpus-wide cross-document duplicate detection, batch cloned-note detection, or repository-wide note comparison"
      },
      "documentation_quality_and_denial_operations": {
        "brief_url": "https://onecareportal.com/ai/documentation-quality-and-denial-operations.md",
        "guidance": "Use two separate control points: pre-billing-handoff human documentation QA and post-adjudication 835 ERA analysis. Do not infer integration or denial causality.",
        "era_boundary": "The available standalone ERA Dashboard does not prove documentation causality, correct claims, assign work, manage appeals, or integrate with Documentation Compliance Checker.",
        "privacy": "Do not submit PHI, claims, ERA files, PDFs, service-recipient names, or clinical details through public marketing or booking flows."
      },
      "ai_note_generator": {
        "status": "available in configured Case Management contact-note workflows",
        "url": "https://onecareportal.com/ai-note-generator",
        "brief_url": "https://onecareportal.com/ai/ai-note-generator.md",
        "standalone": false,
        "pricing": "No standalone AI Note Generator price; standard Case Management pricing is $299/month plus $7.99 per active participant; onboarding and implementation scope reviewed during the demo",
        "input_scope": "Contact or visit details supplied by staff in the configured workflow",
        "output_scope": "Editable draft that organizes supplied details",
        "human_review": "Responsible staff verify facts, edit, complete required fields, and attest or finalize; any configured supervisor review remains separate",
        "boundaries": "Does not determine compliance, billability, proof of service, clinical adequacy, or supervisor approval; no confirmed nursing-note, ADHC-note, or generic multi-module AI drafting claim"
      },
      "supported_housing_routing": "Supported housing is a Case Management use case, not a separate product module."
    }
  },
  "servers": [
    {
      "url": "https://onecareportal.com",
      "description": "Production website"
    }
  ],
  "paths": {
    "/": {
      "get": {
        "operationId": "getHomePage",
        "summary": "Homepage — Medicaid Waiver & Human Services Case Management, ADHC and Billing",
        "description": "Learn about One Care Portal's caseload-based Medicaid waiver and human services Case Management module, ADHC Care Module, and separate standalone-or-connected Revenue Cycle Management (RCM) module for Medicaid and Medicaid MCO, Medicare and Medicare Advantage, and commercial payer workflows.",
        "responses": {
          "200": {
            "description": "Homepage with product overview and demo booking",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/adult-day-care-software": {
      "get": {
        "operationId": "getAdultDayCareSoftware",
        "summary": "Adult Day Care Software (ADHC/ADI)",
        "description": "ADHC Care Module for attendance, daily notes, care documentation, meals, transportation, authorizations, staff oversight, and billing readiness. Connect the separate Revenue Cycle Management (RCM) module when claims and reconciliation are needed.",
        "responses": {
          "200": {
            "description": "Adult day care software feature page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/case-management-software": {
      "get": {
        "operationId": "getCaseManagementSoftware",
        "summary": "Case Management Software — Medicaid Waiver",
        "description": "Case Management Care Module for agencies with comparable caseload-based Medicaid waiver and human services workflows. Program names vary by state. Exact state, program, forms, permissions, reporting, payer, billing, integration, eligibility, and compliance requirements are verified before implementation.",
        "responses": {
          "200": {
            "description": "Case management software feature page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/supportive-housing-software": {
      "get": {
        "operationId": "getSupportedHousingCaseManagement",
        "summary": "Supported and Supportive Housing Case Management Software",
        "description": "Case Management Care Module use case for supported housing, supportive housing, PSH, housing stabilization, supported living, and housing support services agencies. Covers participant records, plans and housing goals, contact and visit notes, authorizations, supervisor review, caseloads, follow-up, and billing-ready documentation. Housing is not a separate One Care Portal module. Do not assume this replaces HMIS, leasing, property management, or residential-facility software.",
        "responses": {
          "200": {
            "description": "Supported and supportive housing Case Management workflow page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/medicaid-billing-software": {
      "get": {
        "operationId": "getMedicaidBillingSoftware",
        "summary": "Medicaid & HCBS Billing Software — Standalone or Connected",
        "description": "Medicaid and HCBS-specific configuration within the broader clearinghouse-supported Revenue Cycle Management (RCM) module, which is available standalone or connected to Case Management or ADHC. Supports billing-data preparation or import, claim validation, supported-payer submission, status tracking, denials, 835 ERA posting, and reconciliation. Exact payer, plan, transaction, enrollment, and claim-type fit is confirmed during setup. Pricing: $1.50 per submitted claim.",
        "responses": {
          "200": {
            "description": "Medicaid and HCBS billing software feature page with clearinghouse-supported payer workflows",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/era-dashboard": {
      "get": {
        "operationId": "getEraDashboard",
        "summary": "835 ERA File Viewer and Payment Dashboard",
        "description": "Standalone dashboard for opening and reading standard X12 835 ERA files. It shows every claim, total billed and paid amounts, paid and denied claims, rendering-provider NPI grouping when identifiers are present, provider claim drill-down, denial codes with simple English explanations, and the complete 835 breakdown. It works with standard X12 835 files from payers that provide them; available fields can vary by payer. Pricing: $99/month plus $0.10 for each claim contained in an ERA file One Care Portal parses.",
        "responses": {
          "200": {
            "description": "Standalone X12 835 file viewer with all-claim detail, billed and paid totals, rendering-provider NPI grouping when present, and readable denial-code explanations",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/waiver-case-management-software": {
      "get": {
        "operationId": "getWaiverCaseManagement",
        "summary": "HCBS Waiver Case Management Software",
        "description": "Configurable case management workflows for agencies across the U.S. with comparable HCBS waiver caseloads. Kentucky SCL, MPW, HCB, and ABI/ABI-LTC are local examples, not the full scope; exact program requirements need verification. Exact state, program, forms, permissions, reporting, payer, billing, integration, eligibility, and compliance requirements are verified before implementation.",
        "responses": {
          "200": {
            "description": "Waiver case management software page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/hcbs-case-management-software": {
      "get": {
        "operationId": "getHCBSCaseManagement",
        "summary": "HCBS Case Management Software",
        "description": "Configurable documentation, authorization, supervisor-review, reporting, and billing-readiness workflows for agencies with comparable HCBS caseloads. No HCBS or state template set is assumed. Exact state, program, forms, permissions, reporting, payer, billing, integration, eligibility, and compliance requirements are verified before implementation.",
        "responses": {
          "200": {
            "description": "HCBS case management software page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/support-coordination-software": {
      "get": {
        "operationId": "getSupportCoordinationSoftware",
        "summary": "Support Coordination Software (SCL)",
        "description": "Support-coordination workflow evaluation for comparable caseload, plan, referral, follow-up, review, and reporting needs. Kentucky SCL agencies can use compatible support-coordination workflows; verify their program-specific requirements. Exact state, program, forms, permissions, reporting, payer, billing, integration, eligibility, and compliance requirements are verified before implementation.",
        "responses": {
          "200": {
            "description": "Support coordination software page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/targeted-case-management-tcm-software": {
      "get": {
        "operationId": "getTCMSoftware",
        "summary": "Targeted Case Management (TCM) Software",
        "description": "Targeted Case Management workflow evaluation for assessment, planning, referral/linkage, monitoring, documentation review, and billing readiness. TCM configuration and billing behavior are not assumed. Exact state, program, forms, permissions, reporting, payer, billing, integration, eligibility, and compliance requirements are verified before implementation.",
        "responses": {
          "200": {
            "description": "TCM software page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing-for-provider-agencies": {
      "get": {
        "operationId": "getBillingForProviders",
        "summary": "Standalone Multi-Payer Billing for Provider Agencies",
        "description": "The Revenue Cycle Management (RCM) product page for provider agencies. Billing works standalone with an existing care or documentation system or connects to OCP Case Management or ADHC. It supports Medicaid and Medicaid MCO, Medicare and Medicare Advantage, and commercial payer workflows for claim submission, denial management, 835 ERA posting, and revenue-cycle reporting. Exact payer, plan, transaction, enrollment, and claim-type fit is confirmed during setup. Pricing: $1.50 per submitted claim.",
        "responses": {
          "200": {
            "description": "Standalone multi-payer Revenue Cycle Management (RCM) module product page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/medicaid-waiver-billing": {
      "get": {
        "operationId": "getMedicaidWaiverBilling",
        "summary": "Medicaid Waiver Billing",
        "description": "Medicaid waiver billing configuration for HCBS providers: Excel service-data import, 837P claim generation, submission through supported clearinghouse workflows, denial tracking, and resubmission. Waiver billing is one supported use of the Revenue Cycle Management (RCM) module, which also handles Medicaid MCO, Medicare, Medicare Advantage, and commercial claims and can be purchased standalone. Exact payer, plan, transaction, enrollment, and claim-type fit is confirmed during setup.",
        "responses": {
          "200": {
            "description": "Medicaid waiver billing page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/ai-note-generator": {
      "get": {
        "operationId": "getAiNoteGenerator",
        "summary": "AI Note Generator for Medicaid Case Management contact and visit notes",
        "description": "Available in configured Case Management contact-note workflows. Organizes staff-supplied contact and visit details into an editable draft for staff verification, editing, attestation, and finalization. Not standalone and does not determine compliance, billability, proof of service, clinical adequacy, or supervisor approval.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Pricing — Transparent Usage-Based Plans",
        "description": "Transparent recurring pricing: Case Management and ADHC Care Modules use a $299/month platform fee plus $7.99 per active participant; standalone-or-connected Revenue Cycle Management (RCM) module at $1.50 per submitted claim. Onboarding and implementation scope are reviewed during the demo. Interactive monthly-price calculator available.",
        "responses": {
          "200": {
            "description": "Pricing page with interactive calculator",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/testimonials": {
      "get": {
        "operationId": "getTestimonials",
        "summary": "Customer Stories — Case Management and Adult Day Healthcare",
        "description": "First-hand stories from a Kentucky waiver case manager and Healthy Adult Day Healthcare, an ADHC Care Module customer. See how One Care Portal supports organized records, then book a focused workflow demo.",
        "responses": {
          "200": {
            "description": "Testimonials and success stories page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/contact": {
      "get": {
        "operationId": "getContact",
        "summary": "Contact & Demo Scheduling",
        "description": "Contact One Care Portal for demos, pricing, or support. Email: support@onecareportal.com. Phone: (502) 509-6887. Schedule a personalized demo via Calendly. Based in Louisville, KY. Response time: same business day.",
        "responses": {
          "200": {
            "description": "Contact page with form and demo booking",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/state/ky": {
      "get": {
        "operationId": "getKentuckyPage",
        "summary": "Kentucky Medicaid Software",
        "description": "Kentucky case management for compatible Michelle P. (MPW), SCL, HCB, and ABI/ABI-LTC caseload workflows, one state example of a Case Management product for agencies across the U.S. KYMMIS, KyHealth Net, and MEUPS are buyer terminology, not claims of built-in integration, eligibility, payer, billing, or compliance support. Exact state, program, forms, permissions, reporting, payer, billing, integration, eligibility, and compliance requirements are verified before implementation.",
        "responses": {
          "200": {
            "description": "Kentucky-specific landing page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/case-management/waiver-documentation-requirements": {
      "get": {
        "operationId": "getWaiverDocRequirements",
        "summary": "Waiver Documentation Requirements Guide",
        "description": "Complete guide to Medicaid waiver documentation requirements: what must be documented, frequency standards, signature requirements, retention periods, and common audit findings.",
        "responses": {
          "200": {
            "description": "Waiver documentation requirements article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/case-management/care-plan-vs-service-plan": {
      "get": {
        "operationId": "getCarePlanVsServicePlan",
        "summary": "Care Plan vs Service Plan — Key Differences",
        "description": "Explains the difference between care plans and service plans in HCBS waiver programs. When each is required, what must be included, and how to document both in compliance with Medicaid standards.",
        "responses": {
          "200": {
            "description": "Care plan vs service plan comparison article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/case-management/contact-note-best-practices": {
      "get": {
        "operationId": "getContactNoteBestPractices",
        "summary": "Contact Note Best Practices for Case Managers",
        "description": "Best practices for writing Medicaid-compliant contact notes. What to include, time-stamping requirements, frequency standards, and how to avoid the most common audit deficiencies.",
        "responses": {
          "200": {
            "description": "Contact note best practices article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/case-management/audit-preparation-checklist": {
      "get": {
        "operationId": "getAuditPreparationChecklist",
        "summary": "Medicaid Audit Preparation Checklist",
        "description": "Step-by-step checklist for preparing for a Medicaid waiver audit. Organized by documentation type: service plans, contact notes, authorizations, billing records, and personnel files.",
        "responses": {
          "200": {
            "description": "Audit preparation checklist article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/case-management/multi-state-compliance-guide": {
      "get": {
        "operationId": "getMultiStateComplianceGuide",
        "summary": "Multi-State Medicaid Compliance Guide",
        "description": "Guide to managing Medicaid compliance across multiple states. Covers documentation differences, billing code variations, and state-specific waiver program requirements.",
        "responses": {
          "200": {
            "description": "Multi-state compliance guide article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/adult-day-care/attendance-tracking-best-practices": {
      "get": {
        "operationId": "getAttendanceTracking",
        "summary": "ADHC Attendance Tracking Best Practices",
        "description": "Best practices for tracking attendance in adult day care programs. Sign-in/sign-out requirements, electronic vs paper systems, Medicaid billing reconciliation, and EVV compliance.",
        "responses": {
          "200": {
            "description": "Attendance tracking best practices article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/adult-day-care/meal-tracking-documentation": {
      "get": {
        "operationId": "getMealTracking",
        "summary": "Adult Day Care Meal Tracking & Documentation",
        "description": "How to track and document meals in ADHC programs. CACFP requirements, meal count documentation, dietary restrictions recording, and Medicaid compliance.",
        "responses": {
          "200": {
            "description": "Meal tracking documentation article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/adult-day-care/transportation-scheduling-workflow": {
      "get": {
        "operationId": "getTransportationScheduling",
        "summary": "Adult Day Care Transportation Scheduling",
        "description": "Workflow guide for managing transportation in adult day care centers. Route optimization, driver assignments, participant pickup/dropoff documentation, and billing integration.",
        "responses": {
          "200": {
            "description": "Transportation scheduling workflow article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/adult-day-care/daily-notes-requirements": {
      "get": {
        "operationId": "getDailyNotesRequirements",
        "summary": "ADHC Daily Notes Requirements",
        "description": "What must be included in adult day care daily notes. Observation requirements, time standards, staff signature requirements, and how daily notes support Medicaid billing.",
        "responses": {
          "200": {
            "description": "Daily notes requirements article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing/medicaid-claim-lifecycle": {
      "get": {
        "operationId": "getMedicaidClaimLifecycle",
        "summary": "Medicaid Claim Lifecycle Explained",
        "description": "Complete walkthrough of the Medicaid claim lifecycle: from service delivery to payment posting. Claim creation, scrubbing, submission, adjudication, ERA receipt, and payment reconciliation.",
        "responses": {
          "200": {
            "description": "Medicaid claim lifecycle article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing/835-era-posting-explained": {
      "get": {
        "operationId": "get835ERAPosting",
        "summary": "835 ERA Posting Explained",
        "description": "How to read and post 835 Electronic Remittance Advice (ERA) files. Payment identification, adjustment codes, denial codes (CO, PR, OA), secondary billing triggers, and reconciliation workflows.",
        "responses": {
          "200": {
            "description": "835 ERA posting guide article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing/denials-workflow-guide": {
      "get": {
        "operationId": "getDenialsWorkflow",
        "summary": "Medicaid Claim Denials Workflow Guide",
        "description": "Step-by-step guide to managing Medicaid claim denials. Common denial reason codes, appeal timelines, corrected claim procedures, and how to reduce denial rates with automated scrubbing.",
        "responses": {
          "200": {
            "description": "Denials workflow guide article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing/clean-claims-checklist": {
      "get": {
        "operationId": "getCleanClaimsChecklist",
        "summary": "Clean Claims Checklist for Medicaid",
        "description": "Pre-submission checklist for clean Medicaid claims. Required fields, eligibility verification, authorization confirmation, service date validation, diagnosis codes, and provider NPI requirements.",
        "responses": {
          "200": {
            "description": "Clean claims checklist article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing/revenue-cycle-optimization": {
      "get": {
        "operationId": "getRevenueCycleOptimization",
        "summary": "Revenue Cycle Optimization for HCBS Providers",
        "description": "Strategies for optimizing revenue cycle in HCBS waiver and adult day care programs. Key performance metrics, denial reduction, timely filing management, and clean claim rate benchmarks.",
        "responses": {
          "200": {
            "description": "Revenue cycle optimization article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/care-coordination/care-coordination-workflow-guide": {
      "get": {
        "operationId": "getCareCoordinationWorkflow",
        "summary": "Care Coordination Workflow Guide",
        "description": "End-to-end guide to care coordination workflows in HCBS programs. Intake, assessment, service plan development, provider assignment, monitoring, and annual review cycles.",
        "responses": {
          "200": {
            "description": "Care coordination workflow guide article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/care-coordination/provider-network-coordination": {
      "get": {
        "operationId": "getProviderNetworkCoordination",
        "summary": "Provider Network Coordination for HCBS",
        "description": "How to manage provider networks in HCBS waiver programs. Provider credentialing, service authorization sharing, communication workflows, and quality monitoring.",
        "responses": {
          "200": {
            "description": "Provider network coordination article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/care-coordination/care-coordinator-caseload-management": {
      "get": {
        "operationId": "getCaseloadManagement",
        "summary": "Care Coordinator Caseload Management",
        "description": "Best practices for managing care coordinator caseloads. Ideal caseload sizes for different waiver programs, task prioritization, documentation efficiency, and productivity benchmarks.",
        "responses": {
          "200": {
            "description": "Caseload management article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/care-coordination/care-coordination-transitions-guide": {
      "get": {
        "operationId": "getCareTransitions",
        "summary": "Care Coordination Transitions Guide",
        "description": "Managing care transitions for HCBS waiver participants. Hospital discharge planning, level of care changes, program transitions, and documentation requirements for continuity of care.",
        "responses": {
          "200": {
            "description": "Care coordination transitions guide article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/care-coordination/care-coordination-software-features-guide": {
      "get": {
        "operationId": "getCareCoordinationSoftwareFeatures",
        "summary": "Care Coordination Software Features Guide",
        "description": "What to look for in care coordination software. Key features: service plan management, referral tracking, provider portal, task automation, reporting, and Medicaid compliance tools.",
        "responses": {
          "200": {
            "description": "Care coordination software features guide article",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/compare/case-management-software": {
      "get": {
        "operationId": "getComparisonPage",
        "summary": "Case Management Software Comparison",
        "description": "Compare One Care Portal to other case management software options including StoriCare, WellSky, Therap, and generic solutions. Focus on Medicaid/HCBS waiver-specific features, pricing, and ease of use.",
        "responses": {
          "200": {
            "description": "Case management software comparison page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/adult-day-care-documentation-software": {
      "get": {
        "operationId": "getBlogADHCDocumentation",
        "summary": "Blog: Adult Day Care Documentation Software",
        "description": "Guide to choosing documentation software for adult day care centers. Covers ADHC-specific documentation requirements, what generic software misses, and how purpose-built software reduces errors.",
        "responses": {
          "200": {
            "description": "Blog post on adult day care documentation software",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/real-cost-generic-software-medicaid": {
      "get": {
        "operationId": "getBlogGenericSoftwareCost",
        "summary": "Blog: Real Cost of Generic Software for Medicaid",
        "description": "Analysis of the hidden costs of using generic software (Excel, generic EHRs) for Medicaid billing. Billing errors, compliance risks, staff time costs, and ROI of switching to purpose-built software.",
        "responses": {
          "200": {
            "description": "Blog post on generic software costs for Medicaid providers",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/switching-to-purpose-built-software": {
      "get": {
        "operationId": "getBlogSwitching",
        "summary": "Blog: Switching to Purpose-Built Software",
        "description": "How to transition from generic or legacy software to purpose-built Medicaid software. Migration planning, staff training, data migration, and avoiding common switching mistakes.",
        "responses": {
          "200": {
            "description": "Blog post on switching to purpose-built healthcare software",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/careers": {
      "get": {
        "operationId": "getCareers",
        "summary": "Careers at One Care Portal",
        "description": "Join the One Care Portal team. We build software for Medicaid-funded healthcare providers. Louisville, KY-based startup. Roles in engineering, customer success, and healthcare operations.",
        "responses": {
          "200": {
            "description": "Careers page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/privacy-policy": {
      "get": {
        "operationId": "getPrivacyPolicy",
        "summary": "Privacy Policy — HIPAA Compliant",
        "description": "One Care Portal privacy policy. HIPAA-compliant data handling, Business Associate Agreement (BAA) availability, data retention policies, and security practices.",
        "responses": {
          "200": {
            "description": "Privacy policy page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/api/ai": {
      "get": {
        "operationId": "getAIProductData",
        "summary": "Limited AI-readable product and buyer-fit data",
        "description": "Public no-auth JSON endpoint for AI assistants. Returns One Care Portal LLC legal identity, buyer-fit guidance, product catalog, commercial terms, onboarding, contact-note capabilities, routing rules, demo URL, login URL for existing customers, and AI-readable markdown resource URLs.",
        "responses": {
          "200": {
            "description": "Structured public product data for AI assistants",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            },
            "headers": {
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the current policy window.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              },
              "RateLimit-Policy": {
                "description": "RFC-style rate-limit policy: 60 requests per 60-second window.",
                "schema": {
                  "type": "string",
                  "example": "60;w=60"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/ai/one-care-portal.md": {
      "get": {
        "operationId": "getAIOneCarePortalMarkdown",
        "summary": "AI-readable company and product summary markdown",
        "description": "AI-readable company and product summary markdown for ChatGPT, Claude, Gemini, Perplexity, and other AI assistants.",
        "responses": {
          "200": {
            "description": "AI-readable company and product summary markdown",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/ai/buyer-fit.md": {
      "get": {
        "operationId": "getAIBuyerFitMarkdown",
        "summary": "AI-readable buyer-fit markdown guide",
        "description": "AI-readable buyer-fit markdown guide for ChatGPT, Claude, Gemini, Perplexity, and other AI assistants.",
        "responses": {
          "200": {
            "description": "AI-readable buyer-fit markdown guide",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/ai/products.md": {
      "get": {
        "operationId": "getAIProductsMarkdown",
        "summary": "AI-readable product catalog markdown",
        "description": "AI-readable product catalog markdown for ChatGPT, Claude, Gemini, Perplexity, and other AI assistants.",
        "responses": {
          "200": {
            "description": "AI-readable product catalog markdown",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/ai/contact-note-documentation.md": {
      "get": {
        "operationId": "getAIContactNoteDocumentationMarkdown",
        "summary": "AI-readable enhanced contact-note documentation brief",
        "description": "AI-readable brief covering goal monitoring, health and safety review, emergency backup planning, satisfaction, resource gaps, carried-forward follow-up, audit controls, and configuration caveats.",
        "responses": {
          "200": {
            "description": "AI-readable enhanced contact-note documentation brief",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/ai/era-dashboard.md": {
      "get": {
        "operationId": "getAIERADashboardMarkdown",
        "summary": "AI-readable 835 ERA Dashboard markdown brief",
        "description": "AI-readable 835 ERA Dashboard markdown brief for ChatGPT, Claude, Gemini, Perplexity, and other AI assistants.",
        "responses": {
          "200": {
            "description": "AI-readable 835 ERA Dashboard markdown brief",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/api/v1": {
      "get": {
        "operationId": "getPublicApiV1Index",
        "summary": "Get the One Care Portal public API v1 index",
        "description": "Returns canonical API links, authentication scope, versioning policy, and rate-limit conventions. This endpoint is public, read-only, and contains no customer data or PHI.",
        "tags": [
          "Public API v1"
        ],
        "responses": {
          "200": {
            "description": "Public API v1 index",
            "headers": {
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the current policy window.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              },
              "RateLimit-Policy": {
                "description": "RFC-style rate-limit policy: 60 requests per 60-second window.",
                "schema": {
                  "type": "string",
                  "example": "60;w=60"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiIndex"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        }
      }
    },
    "/api/v1/catalog": {
      "get": {
        "operationId": "getPublicProductCatalogV1",
        "summary": "Get the One Care Portal public product catalog",
        "description": "Returns typed public product, pricing, and contact information. This endpoint is public, read-only, and contains no customer data or PHI.",
        "tags": [
          "Public API v1"
        ],
        "responses": {
          "200": {
            "description": "Versioned One Care Portal product catalog",
            "headers": {
              "RateLimit-Limit": {
                "description": "Maximum requests allowed in the current policy window.",
                "schema": {
                  "type": "integer",
                  "example": 60
                }
              },
              "RateLimit-Policy": {
                "description": "RFC-style rate-limit policy: 60 requests per 60-second window.",
                "schema": {
                  "type": "string",
                  "example": "60;w=60"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductCatalog"
                }
              }
            }
          },
          "404": {
            "$ref": "#/components/responses/Problem"
          },
          "405": {
            "$ref": "#/components/responses/Problem"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "default": {
            "$ref": "#/components/responses/Problem"
          }
        }
      }
    },
    "/case-management": {
      "get": {
        "operationId": "getCaseManagementHub",
        "summary": "Case Management Resource Hub",
        "description": "Comprehensive resource hub for Medicaid case managers. Guides on waiver documentation, care plan best practices, audit preparation, and state compliance.",
        "responses": {
          "200": {
            "description": "Case management hub landing page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/adult-day-care": {
      "get": {
        "operationId": "getAdultDayCareHub",
        "summary": "Adult Day Care Resource Hub",
        "description": "Resource hub for adult day care (ADHC/ADI) program administrators. Guides on attendance tracking, documentation standards, meal requirements, transportation, and Medicaid compliance.",
        "responses": {
          "200": {
            "description": "Adult day care hub landing page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing": {
      "get": {
        "operationId": "getBillingHub",
        "summary": "Medicaid Billing Resource Hub",
        "description": "Comprehensive resource hub for Medicaid billing teams. Guides on claim lifecycle, ERA posting, denial management, clean claims, and revenue cycle optimization.",
        "responses": {
          "200": {
            "description": "Billing hub landing page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/care-coordination": {
      "get": {
        "operationId": "getCareCoordinationHub",
        "summary": "Care Coordination Resource Hub",
        "description": "Resource hub for care coordinators in HCBS and community-based programs. Guides on coordination workflows, provider networks, caseload management, and care transitions.",
        "responses": {
          "200": {
            "description": "Care coordination hub landing page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/standalone-billing-hub-excel-claims": {
      "get": {
        "operationId": "getStandaloneBillingHubExcelClaimsGuide",
        "summary": "Standalone Revenue Cycle Management (RCM) and Excel-to-claims guide",
        "description": "Explains standalone RCM, spreadsheet import, mapping, validation, supported-payer submission, claim status, denials, 835 ERA work, and reconciliation.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/service-authorization-management-medicaid-waiver-software": {
      "get": {
        "operationId": "getServiceAuthorizationTrackingGuide",
        "summary": "Service authorization tracking and authorization-aware scheduling",
        "description": "Explains authorization periods, units or amounts, rates, unit calculation, expiration, utilization, and schedule-time coverage checks.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/unlimited-participant-staff-document-management": {
      "get": {
        "operationId": "getUnlimitedParticipantStaffDocumentGuide",
        "summary": "Unlimited participant and staff document management guide",
        "description": "Explains participant and staff document workflows, expiration metadata, expiring and expired reports, access, retention, and governance boundaries.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/case-management-supervisor-contact-note-review": {
      "get": {
        "operationId": "getSupervisorContactNoteReviewGuide",
        "summary": "Case management supervisor contact-note review guide",
        "description": "Explains author attestation, required supervisor review, approval, return with reasons, amendments, roles, queues, and audit history.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/ai-note-generator-medicaid-documentation": {
      "get": {
        "operationId": "getAiNoteGeneratorDocumentationGuide",
        "summary": "AI Note Generator for Medicaid documentation",
        "description": "Human-review guidance for AI-assisted drafts. Confirmed live product scope is configured Case Management contact-note workflows, including staff-supplied contact and visit details; nursing-note, ADHC-note, and generic multi-module generation are not represented as confirmed live capabilities.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/blog/emr-ehr-interoperability-medicaid-provider-software": {
      "get": {
        "operationId": "getEmrEhrInteroperabilityFitGuide",
        "summary": "EMR and EHR interoperability and fit guide",
        "description": "Separates verified imports, exports, and provider-agency workflows from implementation-dependent interfaces and unsupported replacement claims.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/ai/platform-workflows.md": {
      "get": {
        "operationId": "getAiPlatformWorkflowGuide",
        "summary": "AI-readable One Care Portal platform workflow guide",
        "description": "Machine-readable answers and claim boundaries for billing, authorizations, documents, supervisor review, AI notes, and EMR or EHR fit.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/documentation-intelligence": {
      "get": {
        "operationId": "getDocumentationIntelligence",
        "summary": "AI-assisted PDF documentation and service-note review for agencies",
        "description": "Available for production use: One Care Portal's Documentation Compliance Checker supports human-reviewed service-note and visit-documentation QA for Medicaid and human-service agencies retaining their source system. Manually uploaded PDFs are processed individually with a maximum of 20 MB per PDF against organization-configured criteria. Possible findings include AI-provided evidence text and a cited PDF page. Text extraction or OCR is not guaranteed. No built-in regulatory library or source-system integration is represented. Discuss review volume, scope, and pricing with our team. Finding dispositions are confirm, dismiss, or resolve; document decisions are approve, return, or escalate. CTA: Discuss Your Documentation Review Workflow. Does not certify or determine compliance, billability, fraud, clinical adequacy, or legal sufficiency.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/documentation-review": {
      "get": {
        "operationId": "getDocumentationReviewHub",
        "summary": "Documentation review educational hub",
        "description": "Educational resources for documentation QA, service-note review, pre-billing review, and human oversight. Education is separate from product availability.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/documentation-review/supervisor-note-review-workflow": {
      "get": {
        "operationId": "getSupervisorNoteReviewWorkflow",
        "summary": "Supervisor note-review workflow guide",
        "description": "Educational guide to source-evidence inspection, possible findings, human dispositions, follow-up, and accountable review history.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/documentation-review/pre-billing-documentation-review": {
      "get": {
        "operationId": "getPreBillingDocumentationReviewGuide",
        "summary": "Pre-billing documentation review guide",
        "description": "Educational guide to documentation QA before a separate billing decision. It does not determine billability, payment, compliance, fraud, clinical adequacy, or legal sufficiency.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/ai/documentation-intelligence.md": {
      "get": {
        "operationId": "getAiDocumentationIntelligenceBrief",
        "summary": "AI-readable PDF documentation review module brief",
        "description": "Machine-readable review workflow, buyer fit, input, output, human-review role, source-system coexistence, privacy guidance, and claim boundaries.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/ai/ai-note-generator.md": {
      "get": {
        "operationId": "getAiNoteGeneratorBrief",
        "summary": "AI-readable AI Note Generator brief",
        "description": "Machine-readable live status, Case Management relationship, input and output scope, human-review duties, boundaries, pricing relationship, demo and guide links, and no-PHI booking guidance.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    },
    "/documentation-review/documentation-quality-and-era-denial-review": {
      "get": {
        "operationId": "getDocumentationQualityAndEraDenialReviewGuide",
        "summary": "Documentation quality and ERA denial review guide",
        "description": "Educational guide separating pre-billing-handoff human documentation QA from post-adjudication 835 ERA analysis. The two control points are separate; no product integration or denial causality is represented.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/documentation-review/duplicate-clinical-notes-copy-forward-risk": {
      "get": {
        "operationId": "getDuplicateClinicalNotesCopyForwardRiskGuide",
        "summary": "Duplicate clinical notes and copy-forward risk guide",
        "description": "CMS-informed educational guide to patient-specific verification, legibility, missing details, contradictions, and copy-forward review. One Care Portal does not claim corpus-wide cross-document duplicate detection as a confirmed capability.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/billing/835-era-denial-worklist": {
      "get": {
        "operationId": "get835EraDenialWorklistGuide",
        "summary": "How to build an 835 ERA denial worklist",
        "description": "Practical guide to organizing payer adjudication results using group codes, CARCs, RARCs, payer and provider views, prioritization, and export into the team's existing follow-up process. An ERA does not contain the underlying clinical note or prove documentation causality.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "description": "Rendered public page content."
                }
              },
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "Website"
        ]
      }
    },
    "/ai/documentation-quality-and-denial-operations.md": {
      "get": {
        "operationId": "getDocumentationQualityAndDenialOperationsBrief",
        "summary": "AI-readable documentation quality and ERA denial operations brief",
        "description": "Machine-readable buyer routing, product status, two-control-point guidance, hard capability boundaries, public resource URLs, and no-PHI guidance.",
        "responses": {
          "200": {
            "description": "Public content resource",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string",
                  "description": "Agent-readable Markdown representation."
                }
              }
            }
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "default": {
            "$ref": "#/components/responses/SiteError"
          }
        },
        "tags": [
          "AI resources"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Problem": {
        "type": "object",
        "description": "RFC 9457 problem details with machine-readable recovery extensions.",
        "required": [
          "type",
          "title",
          "status",
          "detail",
          "instance",
          "code",
          "resolution_hint"
        ],
        "properties": {
          "type": {
            "type": "string",
            "format": "uri-reference"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "integer",
            "minimum": 400,
            "maximum": 599
          },
          "detail": {
            "type": "string"
          },
          "instance": {
            "type": "string",
            "format": "uri-reference"
          },
          "code": {
            "type": "string",
            "pattern": "^[A-Z][A-Z0-9_]+$"
          },
          "resolution_hint": {
            "type": "string"
          },
          "documentation_url": {
            "type": "string",
            "format": "uri"
          }
        },
        "additionalProperties": true
      },
      "Contact": {
        "type": "object",
        "required": [
          "email",
          "phone",
          "location"
        ],
        "properties": {
          "email": {
            "type": "string",
            "format": "email"
          },
          "phone": {
            "type": "string"
          },
          "location": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "Product": {
        "type": "object",
        "required": [
          "id",
          "name",
          "url",
          "pricing"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "format": "uri"
          },
          "pricing": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "ProductCatalog": {
        "type": "object",
        "required": [
          "api_version",
          "name",
          "legal_name",
          "canonical_url",
          "demo_url",
          "existing_customer_login_url",
          "contact",
          "products",
          "links"
        ],
        "properties": {
          "api_version": {
            "type": "string",
            "const": "v1"
          },
          "name": {
            "type": "string"
          },
          "legal_name": {
            "type": "string"
          },
          "canonical_url": {
            "type": "string",
            "format": "uri"
          },
          "demo_url": {
            "type": "string",
            "format": "uri"
          },
          "existing_customer_login_url": {
            "type": "string",
            "format": "uri"
          },
          "contact": {
            "$ref": "#/components/schemas/Contact"
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Product"
            }
          },
          "links": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "format": "uri"
            }
          }
        },
        "additionalProperties": false
      },
      "ApiIndex": {
        "type": "object",
        "required": [
          "api_version",
          "name",
          "description",
          "documentation_url",
          "openapi_url",
          "catalog_url",
          "versioning_policy_url",
          "authentication",
          "rate_limit"
        ],
        "properties": {
          "api_version": {
            "type": "string",
            "const": "v1"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "documentation_url": {
            "type": "string",
            "format": "uri"
          },
          "openapi_url": {
            "type": "string",
            "format": "uri"
          },
          "catalog_url": {
            "type": "string",
            "format": "uri"
          },
          "versioning_policy_url": {
            "type": "string",
            "format": "uri"
          },
          "authentication": {
            "type": "string"
          },
          "rate_limit": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "additionalProperties": false
      }
    },
    "responses": {
      "NotAcceptable": {
        "description": "Neither HTML nor Markdown is acceptable to the client.",
        "headers": {
          "Vary": {
            "description": "The representation varies by the Accept request header.",
            "schema": {
              "type": "string",
              "const": "Accept"
            }
          }
        },
        "content": {
          "text/markdown": {
            "schema": {
              "type": "string",
              "description": "Agent-readable Markdown representation."
            }
          }
        }
      },
      "SiteError": {
        "description": "Public website error response with human- or agent-readable recovery content.",
        "content": {
          "text/html": {
            "schema": {
              "type": "string",
              "description": "Rendered public page content."
            }
          },
          "text/markdown": {
            "schema": {
              "type": "string",
              "description": "Agent-readable Markdown representation."
            }
          }
        }
      },
      "Problem": {
        "description": "Structured RFC 9457 error",
        "headers": {
          "RateLimit-Limit": {
            "description": "Maximum requests allowed in the current policy window.",
            "schema": {
              "type": "integer",
              "example": 60
            }
          },
          "RateLimit-Policy": {
            "description": "RFC-style rate-limit policy: 60 requests per 60-second window.",
            "schema": {
              "type": "string",
              "example": "60;w=60"
            }
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            }
          }
        }
      },
      "RateLimited": {
        "description": "Rate limit exceeded",
        "headers": {
          "RateLimit-Limit": {
            "description": "Maximum requests allowed in the current policy window.",
            "schema": {
              "type": "integer",
              "example": 60
            }
          },
          "RateLimit-Policy": {
            "description": "RFC-style rate-limit policy: 60 requests per 60-second window.",
            "schema": {
              "type": "string",
              "example": "60;w=60"
            }
          },
          "Retry-After": {
            "description": "Seconds until the client should retry.",
            "schema": {
              "type": "integer",
              "minimum": 1
            }
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "One Care Portal developer resources",
    "url": "https://onecareportal.com/developers"
  },
  "x-api-versioning": {
    "strategy": "URL path major versions",
    "current": "v1",
    "policy": "https://onecareportal.com/docs/api-versioning",
    "minimum_deprecation_notice_days": 180,
    "deprecation_headers": [
      "Deprecation",
      "Link",
      "Sunset"
    ]
  },
  "x-rate-limit": {
    "limit": 60,
    "window_seconds": 60,
    "aggregate_by": [
      "domain",
      "client IP"
    ],
    "response_headers": [
      "RateLimit-Limit",
      "RateLimit-Policy",
      "Retry-After on 429"
    ]
  },
  "tags": [
    {
      "name": "Website",
      "description": "Public website pages with HTML and negotiated Markdown representations."
    },
    {
      "name": "Public API v1",
      "description": "Versioned, read-only, no-auth, non-PHI public catalog API."
    },
    {
      "name": "AI resources",
      "description": "Public machine-readable resources for agents."
    }
  ],
  "security": []
}
