Glossary
Terms below appear in API request and response payloads and across these docs. Each one carries a specific meaning in CAIL.
Jurisdiction
A regional health service area with its own clinical framework and terminology, for example a national health service region. Endpoint behavior varies by jurisdiction in defined ways: emergency department terminology, provider taxonomy, and wait-time semantics. The jurisdiction a request resolves to is determined by the caller’s authentication context or location, and is included on relevant responses.
Health board
A regional administrative organization that operates services within a jurisdiction. Modeled as a FHIR Organization.
Provider
A clinical service delivery organization (a hospital, a GP practice, a community service). Modeled as a FHIR Organization with type information from the jurisdiction’s terminology.
Healthcare service
A specific service offered by a provider, for example “general practice” or “minor injuries unit”. Modeled as a FHIR HealthcareService.
PlanDefinition
A versioned clinical decision tree or care pathway. Modeled as a FHIR PlanDefinition. Patient clients fetch the active PlanDefinition for a jurisdiction and traverse it locally.
QuestionnaireResponse
A patient’s answers submitted while traversing a PlanDefinition. Modeled as a FHIR QuestionnaireResponse.
Wait-time pressure band
A label (for example green, amber, red) summarizing current wait-time signal for an emergency department or service. The band is derived per jurisdiction so callers can compare across regions.
Emergency terminology
The regionally appropriate label for emergency departments (for example “A&E”, “ED”). Returned by the API so client copy stays consistent with local conventions.
PREM
Patient Reported Experience Measure. Structured patient feedback submitted through dedicated endpoints and aggregated for reporting.
MeasureReport
An aggregate metrics resource produced on a recurring schedule. Modeled as a FHIR MeasureReport.
Commissioner
The administrative consumer of CAIL on the commissioner side: an analyst, manager, or operator inside a health board organization. Authenticated through Auth0.