{ "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. 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" } }, "servers": [ { "url": "https://onecareportal.com", "description": "Production website" } ], "paths": { "/": { "get": { "operationId": "getHomePage", "summary": "Homepage — Medicaid & HCBS Case Management, ADHC and Billing", "description": "Learn how One Care Portal supports Medicaid and HCBS operations, compliant documentation, staff oversight, audit readiness, and clearinghouse-supported billing. Case Management and ADHC are adjacent Care Modules; Billing works standalone or connected.", "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 Billing 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 calendars, visit scheduling, notes, supervisor approval or return with feedback, caseloads, completed work, hours, authorizations, billing readiness, and audit-ready exports.", "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": "Separate clearinghouse-supported Billing Module 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, with specialized Medicaid and HCBS workflows. Exact payer fit is confirmed during implementation. 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: $199/month base plus $0.10 per claim or remit claim reviewed.", "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": "Specialized HCBS waiver case management with state-specific templates, authorization tracking, and audit-ready reporting. Supports MPW (Michelle P Waiver), SCL, ROSE, ACQUIRE waiver programs in Kentucky and other states.", "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": "Home and Community-Based Services (HCBS) case management platform. Supports waiver coordinators managing participant-centered service plans, provider coordination, and Medicaid compliance documentation.", "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": "SCL (Supports for Community Living) support coordination software. Streamlines documentation for IDD/DD waiver support coordinators: person-centered plans, quarterly reports, annual reviews, incident reporting.", "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": "TCM software for Medicaid-funded targeted case management agencies. Automates contact notes, service plans, billing codes, and state reporting. Helps reduce administrative burden with reusable workflows and billing-ready documentation.", "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": "Medicaid Billing for Provider Agencies", "description": "Full-service Medicaid billing module for HCBS provider agencies. Handles claim submission, denial management, ERA posting, and revenue cycle reporting. Transparent pricing: $1.50 per submitted claim.", "responses": { "200": { "description": "Billing for provider agencies 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 automation for HCBS providers. Supports all waiver program billing codes, EVV integration, and timely filing compliance. Reduces claim rejections with automated scrubbing.", "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 — Clinical & Case Notes", "description": "AI-assisted nursing note and case note generator. Turn staff observations into structured drafts for human review before final documentation. Supports: contact notes, nursing notes, progress notes, daily notes.", "responses": { "200": { "description": "AI note generator 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" ] } }, "/pricing": { "get": { "operationId": "getPricing", "summary": "Pricing — Transparent Usage-Based Plans", "description": "Transparent pricing: Case Management and ADHC Care Modules at $5.99 per active participant per month; standalone-or-connected Billing Module at $1.50 per submitted claim. Interactive pricing 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 Reviews — ADHC & Case Management Agencies", "description": "Customer stories and workflow examples from adult day care centers, HCBS teams, and case management agencies.", "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": "One Care Portal for Kentucky Medicaid providers. Supports Kentucky-specific waiver programs: SCL (Supports for Community Living), MPW (Michelle P Waiver), ACQUIRE, ROSE. Familiar with DCBS and CHFS reporting requirements.", "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, contact, and routing 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" ] } } }, "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": [] }