Chronic Kidney Disease (CKD)

PH4035 / 9627

Samira Bell, Amy Coombe, Ross Forsyth, Anna Stevenson, Jadene Lewis, Laura Sherlock

Jul 16, 2026

BHF Data Science Centre Phenotype

  1. Overview

    Project Name
    Kidney Data Science Catalyst
    Phenotype Type
    Disease or syndrome
    Sex
    Both
    Valid Event Date Range
    No data
    Coding System
    SNOMED CT codesICD10 codesOPCS4 codes
    Data Sources
    GPES Data for Pandemic Planning and Research (COVID-19)
    Hospital Episode Statistics Admitted Patient Care
    Ontology
    No data
    Collections
    BHF Data Science Centre
    Tags
    No data

  2. Definition

    Definition

    This phenotype is a rule-based Chronic Kidney Disease (CKD) phenotyping algorithm designed for use in electronic health records (EHR) to identify and stage people with CKD and from routinely collected health data. The algorithm was developed by a multidisciplinary working group to translate established clinical definitions of CKD into operational definitions that can be consistently applied to large-scale health datasets. The algorithm has been developed iteratively, and multiple versions are available to reflect updates and refinements over time.

    Documentation relating to algorithm development and implementation are available here (please download the .html file from the GitHub link to view).

    Further code lists related to the CKD phenotyping algorithm implementation are also on the Phenotype Library:

    • Dialysis available here (PH4036)

    • Transplant available here (PH4037)

    • Congenital kidney disease available here (PH4038)

    Clinical Trials

    No Trials

    Endorsements

    No endorsement

  3. Implementation

    Implementation

    This phenotype is implemented as a rule-based algorithm for application to electronic health records, using structured logic applied to diagnosis, and laboratory data to identify CKD status and staging. The implementation is coded in PySpark is publicly available through the BHF Data Science Centre GitHub..

  4. Clinical Codelist

  5. Publication

    Related publications

    No known publications

    Citation Example

    Samira Bell, Amy Coombe, Ross Forsyth, Anna Stevenson, Jadene Lewis, Laura Sherlock. PH4035 / 9627 - Chronic Kidney Disease (CKD). Phenotype Library [Online]. 16 July 2026. Available from: http://phenotypes.healthdatagateway.org/phenotypes/PH4035/version/9627/detail/. [Accessed 16 July 2026]

  6. API

    To Export Phenotype Details:

    FormatAPI
    JSON site_root/api/v1/phenotypes/PH4035/version/9627/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(
     'PH4035',
     version_id=9627
    )

    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(
     'PH4035',
     version_id=9627
    )

    To Export Phenotype Code List:

    FormatAPI
    JSON site_root/api/v1/phenotypes/PH4035/version/9627/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(
     'PH4035',
     version_id=9627
    )

    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(
     'PH4035',
     version_id=9627
    )

  7. Version History

    Version IDNameOwnerPublish date
    Chronic Kidney Disease (CKD) anna.stevenson2026-07-16 14:53
    9272 Chronic Kidney Disease anna.stevenson2026-03-26 11:58
    9237 Chronic Kidney Disease anna.stevenson2026-02-10 09:46