Severe Liver Disease

PH3716 / 8840

OpenSAFELY

Jan 26, 2026

REGISTERING DOI...

OpenCodelists Phenotype

  1. Overview

    Codelist ID
    opensafely/severe-liver-disease
    Version ID
    5a033839
    Coding System
    SNOMED CT codes
    Collections
    OpenCodelistPhenotype Library
    Tags
    No data

  2. Definition

    This codelist was taken from OpenCodelists, created by OpenSAFELY. We recommend viewing this Phenotype on the OpenCodelist website to view the most recent version.

    This codelist aims to identify patients with severe liver disease.

    © University of Oxford for the Bennett Institute for Applied Data Science 2025. This work may be copied freely for non-commercial research and study.

  3. Methodology

    Search Terms: Cirrhosis / Cirrhosis of the liver / Decompensated / Decompensated liver / Child pugh C / Ascites / Oesophageal varices / Portal Hypertension / Hepatic encephalopathy /

    Inclusion Criteria for Codes: Codes which when applied in clinical records, are expected to refer to severe liver disease in >90% cases.

    Borderline cases which were excluded: - Hepatocellular cancers - a serious but not necessarily a severe liver disease. - Primary biliary cirrhosis - unlikely to consistently reflect severe liver disease. - Fetal ascites - causes of fetal ascites are more diverse and less likely to related to liver disease.

    Borderline cases which were included: - Cirrhosis of liver (and other non-specific codes that don't indicate severity) - debatable how consistently they would reflect severe liver disease. - Ascites - debateable how consistently a code for ascites in isolation would reflect severe liver disease. - Portal hypertension - non-hepatic causes of portal hypertension do exist, so debatable how consistently it would reflect severe liver disease.

  4. References

    Source Reference

    https://www.opencodelists.org/codelist/opensafely/severe-liver-disease/5a033839

    References

  5. Clinical Codelist

  6. API

    To Export Phenotype Details:

    FormatAPI
    JSON site_root/api/v1/phenotypes/PH3716/version/8840/detail/?format=json
    R Package

    # Download here

    library(ConceptLibraryClient)


    # Connect to API

    client = ConceptLibraryClient::Connection$new(public=TRUE)


    # Get details of Phenotype

    phenotype_details = client$phenotypes$get_detail(
     'PH3716',
     version_id=8840
    )

    Py Package

    # Download here

    from pyconceptlibraryclient import Client


    # Connect to API

    client = Client(public=True)


    # Get details of Phenotype

    phenotype_detail = client.phenotypes.get_detail(
     'PH3716',
     version_id=8840
    )

    To Export Phenotype Code List:

    FormatAPI
    JSON site_root/api/v1/phenotypes/PH3716/version/8840/export/codes/?format=json
    R Package

    # Download here

    library(ConceptLibraryClient)


    # Connect to API

    client = ConceptLibraryClient::Connection$new(public=TRUE)


    # Get codelist of Phenotype

    phenotype_codelist = client$phenotypes$get_codelist(
     'PH3716',
     version_id=8840
    )

    Py Package

    # Download here

    from pyconceptlibraryclient import Client


    # Connect to API

    client = Client(public=True)


    # Get codelist of Phenotype

    phenotype_codelist = client.phenotypes.get_codelist(
     'PH3716',
     version_id=8840
    )

  7. Version History

    Version IDNameOwnerPublish date
    Severe Liver Disease ieuan.scanlon2026-01-26 23:31