> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.cail.health/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.cail.health/_mcp/server.

# 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.