# CAIL Health | Documentation Instructions for AI Agents: - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL ## Docs - [CAIL Health documentation](https://docs.cail.health/.md): Healthcare access infrastructure for HMOs, provider networks, and health system operators. - [Overview](https://docs.cail.health/welcome.md) - [Make an API request](https://docs.cail.health/getting-started/make-an-api-request.md): Authenticate and call your first endpoint - [Glossary](https://docs.cail.health/glossary.md): Terms used in the CAIL Health API and these docs - [FHIR R4 in CAIL Health](https://docs.cail.health/concepts/fhir-r4-in-cail.md): The shape of clinical resources on the wire - [Jurisdictions](https://docs.cail.health/concepts/jurisdictions.md): How regional differences are resolved - [Auth model](https://docs.cail.health/concepts/auth-model.md): Two audiences, two identity providers - [Find providers near a member](https://docs.cail.health/guides/find-providers-near-a-member.md): Search ranked, available providers around a location - [Navigate a member to care](https://docs.cail.health/guides/navigate-a-member-to-care.md): Run a pathway from location to a chosen provider - [Check provider wait times](https://docs.cail.health/guides/check-provider-wait-times.md): Read current wait times and contribute observations - [Author and publish a care pathway](https://docs.cail.health/guides/author-and-publish-a-care-pathway.md): Draft, revise, and activate a routing pathway - [Solutions](https://docs.cail.health/solutions.md): Who uses CAIL Health and what they get out of it - [Provider operators](https://docs.cail.health/solutions/provider-operators.md): Hospital, clinic, pharmacy, lab, and specialist networks - [Payers and employers](https://docs.cail.health/solutions/payers-employers.md): HMOs, large employers, and self-funded corporate schemes - [CAIL Health for HMOs](https://docs.cail.health/solutions/payers-employers/hmos/overview.md): Member navigation that drives appropriate utilization - [Public health and programs](https://docs.cail.health/solutions/public-health.md): Government agencies and donor-funded health programs - [Care navigators and aggregators](https://docs.cail.health/solutions/care-navigators.md): Telemedicine platforms, urgent care coordinators, and provider brokers - [Get in touch](https://docs.cail.health/solutions/get-in-touch.md): Demo, pilot, or a discovery conversation - [Introduction](https://docs.cail.health/api-reference/introduction.md): Orientation for integrating with the CAIL Health API - [Authentication](https://docs.cail.health/api-reference/authentication.md): The two token paths and how to send a token - [Errors](https://docs.cail.health/api-reference/errors.md): How the API reports failures - [Versioning](https://docs.cail.health/api-reference/versioning.md): How the API is versioned - [Error envelope](https://docs.cail.health/reference/error-envelope.md): The shape of error responses - [Pagination](https://docs.cail.health/reference/pagination.md): Cursor-based paging across list endpoints ## API Docs - [Get the active pathway for a member location](https://docs.cail.health/api-references/api-reference/understand-coverage/get-active.md): API Reference > Understand Coverage - [Get a pathway by identifier](https://docs.cail.health/api-references/api-reference/understand-coverage/get.md): API Reference > Understand Coverage - [Create a pathway draft](https://docs.cail.health/api-references/api-reference/understand-coverage/create-draft.md): API Reference > Understand Coverage - [Update a pathway draft](https://docs.cail.health/api-references/api-reference/understand-coverage/update-draft.md): API Reference > Understand Coverage - [Publish a pathway draft](https://docs.cail.health/api-references/api-reference/understand-coverage/publish.md): API Reference > Understand Coverage - [Resolve a jurisdiction by coordinates](https://docs.cail.health/api-references/api-reference/understand-coverage/resolve.md): API Reference > Understand Coverage - [List jurisdictions visible to your organisation](https://docs.cail.health/api-references/api-reference/understand-coverage/list.md): API Reference > Understand Coverage - [Get jurisdiction configuration](https://docs.cail.health/api-references/api-reference/understand-coverage/get-jurisdiction-config.md): API Reference > Understand Coverage - [List navigation sessions](https://docs.cail.health/api-references/api-reference/navigate-to-care/list.md): API Reference > Navigate to Care - [Start a pathway execution](https://docs.cail.health/api-references/api-reference/navigate-to-care/start.md): API Reference > Navigate to Care - [Get a pathway execution envelope](https://docs.cail.health/api-references/api-reference/navigate-to-care/get-envelope.md): API Reference > Navigate to Care - [Get the current node of a pathway execution](https://docs.cail.health/api-references/api-reference/navigate-to-care/get-current-node.md): API Reference > Navigate to Care - [Submit an answer and advance the execution](https://docs.cail.health/api-references/api-reference/navigate-to-care/submit-answer.md): API Reference > Navigate to Care - [Acknowledge a completed pathway execution](https://docs.cail.health/api-references/api-reference/navigate-to-care/complete.md): API Reference > Navigate to Care - [Abandon a pathway execution](https://docs.cail.health/api-references/api-reference/navigate-to-care/abandon.md): API Reference > Navigate to Care - [Create an organisation](https://docs.cail.health/api-references/api-reference/manage-your-organization/create.md): API Reference > Manage Your Organization - [Update an organisation](https://docs.cail.health/api-references/api-reference/manage-your-organization/update.md): API Reference > Manage Your Organization - [Get organisation onboarding status](https://docs.cail.health/api-references/api-reference/manage-your-organization/get-onboarding-status.md): API Reference > Manage Your Organization - [List organisation members](https://docs.cail.health/api-references/api-reference/manage-your-organization/get-members.md): API Reference > Manage Your Organization - [Invite a member](https://docs.cail.health/api-references/api-reference/manage-your-organization/invite.md): API Reference > Manage Your Organization - [Remove a member](https://docs.cail.health/api-references/api-reference/manage-your-organization/remove-member.md): API Reference > Manage Your Organization - [Change a member’s role](https://docs.cail.health/api-references/api-reference/manage-your-organization/change-role.md): API Reference > Manage Your Organization - [List custom roles for an organisation](https://docs.cail.health/api-references/api-reference/manage-your-organization/list-roles.md): API Reference > Manage Your Organization - [Create a custom role](https://docs.cail.health/api-references/api-reference/manage-your-organization/create-role.md): API Reference > Manage Your Organization - [Update a custom role](https://docs.cail.health/api-references/api-reference/manage-your-organization/update-role.md): API Reference > Manage Your Organization - [Delete a custom role](https://docs.cail.health/api-references/api-reference/manage-your-organization/delete-role.md): API Reference > Manage Your Organization - [Get a role’s permissions](https://docs.cail.health/api-references/api-reference/manage-your-organization/get-role-permissions.md): API Reference > Manage Your Organization - [Update a role’s permissions](https://docs.cail.health/api-references/api-reference/manage-your-organization/update-role-permissions.md): API Reference > Manage Your Organization - [Get organisation branding](https://docs.cail.health/api-references/api-reference/manage-your-organization/get.md): API Reference > Manage Your Organization - [Update organisation branding](https://docs.cail.health/api-references/api-reference/manage-your-organization/set.md): API Reference > Manage Your Organization - [Get the calling user’s role and permissions](https://docs.cail.health/api-references/api-reference/manage-your-organization/get-my-permissions.md): API Reference > Manage Your Organization - [Get the calling user’s profile](https://docs.cail.health/api-references/api-reference/manage-your-organization/me.md): API Reference > Manage Your Organization - [List PREM responses](https://docs.cail.health/api-references/api-reference/share-feedback/list.md): API Reference > Share Feedback - [Submit a PREM response](https://docs.cail.health/api-references/api-reference/share-feedback/submit.md): API Reference > Share Feedback - [Get aggregated PREM metrics](https://docs.cail.health/api-references/api-reference/share-feedback/summary.md): API Reference > Share Feedback - [List configured alert rules](https://docs.cail.health/api-references/api-reference/configure-access-policy/list.md): API Reference > Configure Access Policy - [Create an alert rule](https://docs.cail.health/api-references/api-reference/configure-access-policy/create.md): API Reference > Configure Access Policy - [Get the alert-rule event catalogue](https://docs.cail.health/api-references/api-reference/configure-access-policy/catalog.md): API Reference > Configure Access Policy - [Toggle an alert rule on or off](https://docs.cail.health/api-references/api-reference/configure-access-policy/toggle.md): API Reference > Configure Access Policy - [Delete an alert rule](https://docs.cail.health/api-references/api-reference/configure-access-policy/delete.md): API Reference > Configure Access Policy - [Get operational policy overrides](https://docs.cail.health/api-references/api-reference/configure-access-policy/get.md): API Reference > Configure Access Policy - [Update operational policy overrides](https://docs.cail.health/api-references/api-reference/configure-access-policy/update.md): API Reference > Configure Access Policy - [Get a snapshot of headline KPIs](https://docs.cail.health/api-references/api-reference/monitor-performance/summary.md): API Reference > Monitor Performance - [Get a bucketed outcome time series](https://docs.cail.health/api-references/api-reference/monitor-performance/time-series.md): API Reference > Monitor Performance - [Get outcome distribution](https://docs.cail.health/api-references/api-reference/monitor-performance/outcomes.md): API Reference > Monitor Performance - [Get hourly distribution of sessions](https://docs.cail.health/api-references/api-reference/monitor-performance/hourly.md): API Reference > Monitor Performance - [Get PREM rating trend](https://docs.cail.health/api-references/api-reference/monitor-performance/prem-trend.md): API Reference > Monitor Performance - [Get presenting-condition distribution](https://docs.cail.health/api-references/api-reference/monitor-performance/conditions.md): API Reference > Monitor Performance - [Get the completion funnel](https://docs.cail.health/api-references/api-reference/monitor-performance/completion.md): API Reference > Monitor Performance - [Get drop-off rate by pathway node](https://docs.cail.health/api-references/api-reference/monitor-performance/pathway-step-dropoff.md): API Reference > Monitor Performance - [Get time-to-outcome distribution](https://docs.cail.health/api-references/api-reference/monitor-performance/time-to-outcome-distribution.md): API Reference > Monitor Performance - [Get A&E diversion-rate trend](https://docs.cail.health/api-references/api-reference/monitor-performance/diversion-rate-trend.md): API Reference > Monitor Performance - [Get notification volume summary](https://docs.cail.health/api-references/api-reference/monitor-performance/notifications-summary.md): API Reference > Monitor Performance - [Get notifications-sent trend](https://docs.cail.health/api-references/api-reference/monitor-performance/notifications-sent-trend.md): API Reference > Monitor Performance - [Generate a MeasureReport](https://docs.cail.health/api-references/api-reference/monitor-performance/generate.md): API Reference > Monitor Performance - [Get a MeasureReport by identifier](https://docs.cail.health/api-references/api-reference/monitor-performance/get.md): API Reference > Monitor Performance - [List notifications](https://docs.cail.health/api-references/api-reference/monitor-performance/list.md): API Reference > Monitor Performance - [Get unread notification count](https://docs.cail.health/api-references/api-reference/monitor-performance/unread-count.md): API Reference > Monitor Performance - [Mark a notification as read](https://docs.cail.health/api-references/api-reference/monitor-performance/mark-read.md): API Reference > Monitor Performance - [Mark all notifications as read](https://docs.cail.health/api-references/api-reference/monitor-performance/mark-all-read.md): API Reference > Monitor Performance - [Stream notifications in real time](https://docs.cail.health/api-references/api-reference/monitor-performance/stream.md): API Reference > Monitor Performance - [Search providers near a location](https://docs.cail.health/api-references/api-reference/find-care/proximity.md): API Reference > Find Care - [Search providers by free-text query](https://docs.cail.health/api-references/api-reference/find-care/text.md): API Reference > Find Care - [Get provider details](https://docs.cail.health/api-references/api-reference/find-care/get-by-id.md): API Reference > Find Care - [Submit a wait-time report](https://docs.cail.health/api-references/api-reference/check-availability/submit.md): API Reference > Check Availability - [Get wait-time analytics for your network](https://docs.cail.health/api-references/api-reference/check-availability/get-analytics.md): API Reference > Check Availability - [Get current wait time for a location](https://docs.cail.health/api-references/api-reference/check-availability/get-for-location.md): API Reference > Check Availability - [List providers in your network](https://docs.cail.health/api-references/api-reference/curate-your-network/list.md): API Reference > Curate Your Network - [Get network capacity stats](https://docs.cail.health/api-references/api-reference/curate-your-network/stats.md): API Reference > Curate Your Network - [Get aggregate trust summary for your network](https://docs.cail.health/api-references/api-reference/curate-your-network/summary.md): API Reference > Curate Your Network - [List providers awaiting verification review](https://docs.cail.health/api-references/api-reference/curate-your-network/queue.md): API Reference > Curate Your Network - [Update a provider verification](https://docs.cail.health/api-references/api-reference/curate-your-network/update.md): API Reference > Curate Your Network - [List verification events for a resource](https://docs.cail.health/api-references/api-reference/curate-your-network/list-events.md): API Reference > Curate Your Network ## OpenAPI Specification - [OpenAPI JSON](https://docs.cail.health/openapi.json): raw OpenAPI 3.1 specification for this API, JSON format - [OpenAPI YAML](https://docs.cail.health/openapi.yaml): raw OpenAPI 3.1 specification for this API, YAML format