regevidencehub-com Incident API

openapi: 3.2.0
info:
  title: CQC Provider Regulatory Decision Layer Incident API
  version: 0.6.0
  description: Remote MCP decision service plus a narrow HTTP x402 compatibility surface for the two primary commercial entry points. Both HTTP routes execute the same deterministic provider engine as MCP.
  contact:
    email: launchcircle.server@gmail.com
  x-guidance: Use /api/v1/registration-scope-preflight for a new or proposed England provider when registration scope or regulated activities are uncertain. Use /api/v1/statutory-notification-preflight for an already-operating or registered provider when an incident may require CQC notification. Provide the facts requested by each schema; the service returns deterministic evidence-linked preflight output and fails closed on stale or incomplete evidence.
  x-cqc-links:
    pricing: https://cqc.regevidencehub.com/pricing
    privacy: https://cqc.regevidencehub.com/privacy
    terms: https://cqc.regevidencehub.com/terms
    support: https://cqc.regevidencehub.com/support
servers:
- url: https://cqc.regevidencehub.com
tags:
- name: Incident
paths:
  /api/v1/statutory-notification-preflight:
    post:
      operationId: cqc-statutory-notification-preflight
      summary: CQC statutory-notification duty preflight
      description: Use for an already-operating or registered England provider when an incident or post-registration event may need notifying to CQC. Returns whether notification is required, route/channel, timing, missing facts and evidence-linked review conditions.
      tags:
      - Incident
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.04'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              description: V0.6 notification facts that close current Regulation 18 coverage gaps.
              properties:
                notification_type:
                  description: The CQC statutory-notification scenario to assess.
                  enum:
                  - death_person_using_service
                  - serious_injury
                  - abuse_or_allegation
                  - police_involvement
                  - service_disruption
                  - dols_outcome
                  - detained_patient_death
                  - detained_patient_awol
                  - registered_person_absence
                  - statement_of_purpose_revision
                  - child_in_adult_psychiatric_unit
                  title: Notification Type
                  type: string
                facts_complete:
                  default: false
                  description: Set true only when the facts relevant to the chosen notification type have been supplied.
                  title: Facts Complete
                  type: boolean
                is_nhs_trust:
                  default: false
                  title: Is Nhs Trust
                  type: boolean
                is_nhs_blood_and_transplant:
                  default: false
                  title: Is Nhs Blood And Transplant
                  type: boolean
                is_primary_medical_service:
                  default: false
                  title: Is Primary Medical Service
                  type: boolean
                event_related_to_regulated_activity:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For death/serious injury: whether it happened while a regulated activity was provided or may have resulted from that activity/how it was provided.'
                  title: Event Related To Regulated Activity
                serious_injury_from_assault:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For serious_injury: whether the injury resulted from an assault. Leave null when unknown; current CQC guidance uses the abuse/allegation notification route for assault-related serious injury, so the generic serious-injury route must not be selected until this discriminator is known.'
                  title: Serious Injury From Assault
                abuse_concerns_person_using_service:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  title: Abuse Concerns Person Using Service
                incident_may_affect_health_safety_welfare:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  title: Incident May Affect Health Safety Welfare
                police_event_is_death_serious_injury_or_abuse:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For police_involvement: whether the event is also a death, serious injury, or abuse/allegation concerning a person using the service. Leave null when unknown; those events use the matching specific notification route rather than the generic police-involvement form.'
                  title: Police Event Is Death Serious Injury Or Abuse
                cannot_meet_assessed_needs_safely:
                  default: false
                  title: Cannot Meet Assessed Needs Safely
                  type: boolean
                safety_system_failure_hours:
                  anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
                  default: null
                  description: 'For service_disruption: duration in hours of the electricity, gas, water, sewerage, fire-alarm or other safety-device failure.'
                  title: Safety System Failure Hours
                dols_outcome_known:
                  default: false
                  title: Dols Outcome Known
                  type: boolean
                dols_application_withdrawn:
                  default: false
                  title: Dols Application Withdrawn
                  type: boolean
                person_detained_or_liable_under_mha:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  title: Person Detained Or Liable Under Mha
                secure_psychiatric_unit:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For AWOL: whether the absence is from an inpatient psychiatric unit designated low, medium or high security.'
                  title: Secure Psychiatric Unit
                absent_past_midnight:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  title: Absent Past Midnight
                awol_return:
                  default: false
                  title: Awol Return
                  type: boolean
                registered_person_absence_days:
                  anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
                  default: null
                  description: 'For registered_person_absence: number of days the registered person has been or is expected to be absent.'
                  title: Registered Person Absence Days
                absence_phase:
                  anyOf:
                  - enum:
                    - planned
                    - emergency_started
                    - return
                    type: string
                  - type: 'null'
                  default: null
                  description: 'For registered_person_absence: whether this is a planned absence, an emergency absence already started, or a return-to-duty update.'
                  title: Absence Phase
                days_until_planned_absence:
                  anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
                  default: null
                  title: Days Until Planned Absence
                emergency_absence_started_working_days_ago:
                  anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
                  default: null
                  title: Emergency Absence Started Working Days Ago
                return_to_duty_working_days_ago:
                  anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
                  default: null
                  title: Return To Duty Working Days Ago
                provider_is_health_service_body:
                  default: false
                  title: Provider Is Health Service Body
                  type: boolean
                registered_manager_condition_applies_to_health_service_body:
                  default: false
                  title: Registered Manager Condition Applies To Health Service Body
                  type: boolean
                statement_of_purpose_revised_days_ago:
                  anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
                  default: null
                  description: 'For statement_of_purpose_revision: number of days since the statement was revised.'
                  title: Statement Of Purpose Revised Days Ago
                service_disruption_staffing_shortage_threatens_safe_operation:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For service_disruption: whether insufficient suitably qualified, skilled and experienced staff prevents or appears likely to threaten safe continuation of the regulated activity.'
                  title: Service Disruption Staffing Shortage Threatens Safe Operation
                service_disruption_physical_damage_threatens_care:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For service_disruption: whether physical damage to premises has or is likely to have a detrimental effect on treatment or care.'
                  title: Service Disruption Physical Damage Threatens Care
                service_disruption_other_safe_continuation_threat:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For service_disruption: whether another event prevents or appears likely to threaten the provider''s ability to carry on the regulated activity safely or in accordance with registration requirements.'
                  title: Service Disruption Other Safe Continuation Threat
                service_disruption_safety_or_utility_failure_present:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For service_disruption: whether there is an electricity/gas/water/sewerage interruption or fire-alarm/other safety-device failure whose duration must be assessed against the Regulation 18 24-hour threshold.'
                  title: Service Disruption Safety Or Utility Failure Present
                person_under_18:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For child_in_adult_psychiatric_unit: whether the person is under 18 years old.'
                  title: Person Under 18
                adult_psychiatric_unit:
                  anyOf:
                  - type: boolean
                  - type: 'null'
                  default: null
                  description: 'For child_in_adult_psychiatric_unit: whether the placement is in a psychiatric ward/unit intended for adults.'
                  title: Adult Psychiatric Unit
                adult_psychiatric_placement_hours:
                  anyOf:
                  - minimum: 0
                    type: integer
                  - type: 'null'
                  default: null
                  description: Continuous duration in hours of the under-18 placement in the adult psychiatric unit.
                  title: Adult Psychiatric Placement Hours
              required:
              - notification_type
              title: NotificationDecisionInput
              type: object
            example:
              notification_type: service_disruption
              facts_complete: true
              cannot_meet_assessed_needs_safely: false
              safety_system_failure_hours: 26
      responses:
        '200':
          description: Evidence-linked deterministic statutory-notification result.
        '402':
          description: Payment Required. Inspect the runtime x402 v2 PAYMENT-REQUIRED header for the authoritative chain, asset, amount and payment requirements.
        '422':
          description: Invalid request.
externalDocs:
  description: Agent-readable usage and capability guide
  url: https://cqc.regevidencehub.com/llms.txt