Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
titleNews and updates
    2021
  • 2024-
  • 05
  • 04-
  • 04: Added diff functionality
  • 2021-03-30: New contents, editorial updates
  • 2020-11-11: Next Generation CDISC Library
  • 2020-07-07: New contents, new endpoint, metadata adjustments for ADaM
  • 2020-02-14: New contents, new endpoints, editorial updates
  • Expand
    titleHistory Prior to 2020...

    2019-11-18: New contents, bug fixes, minor browser patch
    2019-09-13: Data standards browser as a new functionality
    2019-07-18: Search API, CSV & Excel exports, new and updated contents, and documentation updates
    2019-04-10: New contents, XML media type (beta functionality), and document revision with new and updated information
    2019-02-15: Initial version

Section

General

  • 02: BC, specialization content, metadata export enhancement & new CT with a new MRCT terminology package
  • 2024-01-09: New CT and BC & specialization content
  • Expand
    titleHistory Prior to 2024...
    • 2023-12-12: New BC & specialization content
    • 2023-11-08: New content: CDASH Model v1.3 and CDASHIG v2.3
    • 2023-10-12: New content: ADaM popPK v1.0 
    • 2023-10-03: New CT and BC & specialization content, new endpoints added to BC API v2
    • 2023-07-06: New CT and BC & specialization content, new API version for accessing BCs & specializations, export bug fixes, and removal of SEND draft content
    • 2023-04-04: New content: 2023 Q1 CT packages, additional CDISC Biomedical Concepts (BC) and related SDTM dataset specializations
    • 2023-01-10: New content: 2022 Q4 CT packages, minor bug fixes

    • 2022-12-07: Added support for CDISC Biomedical Concepts (BC) and related SDTM dataset specializations
    • 2022-10-04: New content: 2022 Q3 CT packages, with a new DDF terminology package; access to informative content as beta feature
    • 2022-06-28: New content: 2022 Q2 CT packages, SENDIG-DART v1.2 as draft content, 6 new QRS Supplements with response metadata
    • 2022-03-29: New content: 2022 Q1 CT packages, enhancements for ADaMIG
    • 2022-01-04: New content: 2021 Q4 CT packages

    • 2021-11-28: New contents
    • 2021-09-29: Added notes about a hot fix
    • 2021-09-28: New contents
    • 2021-06-28: New contents, new endpoints, new features
    • 2021-05-04: Added diff functionality
    • 2021-03-30: New contents, editorial updates
    • 2020-11-11: Next Generation CDISC Library
    • 2020-07-07: New contents, new endpoint, metadata adjustments for ADaM
    • 2020-02-14: New contents, new endpoints, editorial updates
    • 2019-11-18: New contents, bug fixes, minor browser patch
    • 2019-09-13: Data standards browser as a new functionality
    • 2019-07-18: Search API, CSV & Excel exports, new and updated contents, and documentation updates
    • 2019-04-10: New contents, XML media type (beta functionality), and document revision with new and updated information
    • 2019-02-15: Initial version
Section

General

Section
bordertrue
Column

Status
colourRed
titleImportant
The 2020-11-11 release is generally known as Next Generation CDISC Library, where CDISC begins to host CDISC Library in Microsoft Azure. To learn more, access the free course NGLIB001: Next Generation CDISC Library on CDISC Learning System.

Section
bordertrue
Column

All access inquires, technical support tickets, comments, and general CDISC Library questions, please use the CDISC Library Product Inquiry form.

Section
bordertrue
Column

The base URL for the API is:

Code Block
linenumberstrue
https://library.cdisc.org/api
Section
bordertrue
Column

The URL for Data Standards Browser is:

Code Block
linenumberstrue
https://library.cdisc.org/browser

Section
bordertrue
Column

Status
subtletrue
colourRed
titleImportant
Introduced as part of the 2023-07-06 release, the base path URL for BC API endpoints have changed with versioning. The endpoints remain unchanged. See technical details in Biomedical Concepts & SpecializationsThe CDISC Library API generally follows HTTP/1.1's guidelines for status code. Details are here: HTTP Status Codes.

Section
bordertrue
Column

All access inquires, technical support tickets, comments, and general CDISC Library questions, please use the CDISC Library Product Inquiry form.

Section
bordertrue
Column

The base URL for the API is:

Code Block
linenumberstrue
https://library.cdisc.org/api

The REST API uses API key authentication.

Note, support for Basic Auth is deprecated as of the 2020-11-11 release. For an interactive walk-through, refer to the video posted on https://www.cdisc.org/cdisc-library/getting-started, starting at 00:44:38.
Section
bordertrue
Column
Info

Content for CDISC Controlled Terminology P43 is available as a patch release dated 2020-11-06. It consists of contents published on 2020-09-25 plus transactional updates from the version dated 2020-11-06.

The following standards have been loaded:

  • CDISC Controlled Terminology P19 (2014-09-26) to P45 (2021-03-26)*, a total of 27 quarters with 110 parts
  • CDASH v1.1.1/CDASHUG v1.0, CDASH Model v1.0 to v1.1, CDASHIG v2.0 to v2.1
  • SDTM v1.2 to v1.8, SDTMIG v3.1.2 to v3.3, SDTMIG-AP v1.0, SDTMIG-PGx v1.0, SDTMIG-MD v1.0, SDTMIG-MD v1.1
  • SENDIG v3.0, SENDIG v3.1.1*, SENDIG-DART v1.1, SENDIG-AR v1.0
  • ADaM v2.1, ADaMIG v1.0 to ADaMIG v1.1 to v1.2, ADaM ADAE v1.0, ADaM TTE for BDS v1.0, ADaM OCCDS v1.0

* denotes new contents added as of the 2021-03-30 release

Section
bordertrue

The URL for Data Standards Browser is:

Code Block
linenumberstrue
https://library.cdisc.org/browser
Section
bordertrue
Column

CDISC Biomedical Concept (BC) API endpoints are now versioned, a change that was introduced in the release on 2023-07-06. For more information, go to Biomedical Concepts & Specializations.

Code Block
linenumberstrue
https://library.cdisc.org/api/cosmos/v2
https://library.cdisc.org/api/cosmos/v1

Note that v2 endpoints are recommended. v1 is for legacy support. A 404 HTTP error will occur when attempting to access BC endpoints without specifying the version.

Section
bordertrue
Column

The CDISC Library API generally follows HTTP/1.1's guidelines for status code. Details are here: HTTP Status Codes.

Section
bordertrue
Column

The REST API uses API key authentication.

Note, support for Basic Auth is deprecated as of the 2020-11-11 release. For an interactive walk-through, refer to the video posted on https://www.cdisc.org/cdisc-library/getting-started, starting at 00:44:38.

Section
bordertrue
column Included in the 2021-05-04 release are:

Enhancements

  • Diff*
    • API endpoint
    • Report as an export from Data Standards Browser

* For details, go to Diff

Corrections & Patches

  • N/A for this release

Deprecations

  • N/A for this release

Enhancements

  • CDISC Glossary. CDISC Glossary is part of CDISC Controlled Terminology. CDISC Library now supports this package type starting P44 (2020-12-18).
  • Draft contents. Users can now access draft contents through the Data Standards Browser and the API. Draft contents are standards available for preview before their publication.

    Data Standards Browser. A new expandable node is added to the left navigation panel.

    Column
    Info

    Content for CDISC Controlled Terminology P43 is available as a patch release dated 2020-11-06. It consists of contents published on 2020-09-25 plus transactional updates from the version dated 2020-11-06.

    An update to the odm-xml schema file is introduced with CDISC Controlled Terminology P49. Version 1.2.0 of the XML schema file on CDISC GitHub DataExchange-CT repo, at https://github.com/cdisc-org/DataExchange-CT/tree/master/schema/ct-1.2.0.

    Status
    colourYellow
    title
    Updated
    Expand
    titleReview information from previous release notes...
    Expand
    titleScreenshot example

    Image Removed

    API. The registrationStatus element has a value of "Draft".

    Expand
    title/mdr/sdtmig/3-4 example output
    Code Block
    linenumberstrue
    {
        "name": "SDTMIG v3.4",
        "registrationStatus": "Draft",
        "source": "CDISC Submission Data Standards Team",
        "version": "3.4"
        ...
    }
  • List of draft contents:
    • SDTMIG v3.4
    • ADaMIG v1.3
  • Corrections & Patches

    • N/A for this release

    Deprecations

    • N/A for this release
    Section
    bordertrue

    updated
    The following standards have been loaded:

    • CDISC Controlled Terminology P19 (2014-09-26) to P57 (2024-03-29)*, a total of 38 publications with 176 parts
    • CDASH v1.1.1/CDASHUG v1.0, CDASH Model v1.0 to v1.3, CDASHIG v2.0 to v2.3
    • SDTM v1.2 to v2.0, SDTMIG v3.1.2 to v3.4, SDTMIG-AP v1.0, SDTMIG-MD v1.0, SDTMIG-MD v1.1
    • SENDIG v3.0, SENDIG v3.1.1, SENDIG-DART v1.1, SENDIG-AR v1.0
    • ADaM v2.1, ADaMIG v1.0 to v1.3, ADaM ADAE v1.0, ADaM TTE for BDS v1.0, ADaM OCCDS v1.0 to v1.1, ADaMIG MD v1.0, ADaMIG NCA v1.0, ADaM popPK v1.0
    • QRS Supplements to SDTMIG: AIMS, APACHE II, ATLAS, HAM-A, KFSS, KPS SCALE, SIX MINUTE WALK, CGI, PGI
    • Biomedical Concepts & SDTM Specializations Package 7*, a total of 302 BCs and 290 SDTM Dataset Specializations, including adverse events, death diagnosis/details, demographics, findings about cardiovascular events, genomics findings, imaging, inclusion/exclusion criteria, laboratory tests, medical history, medical procedures, product administration, subject characteristics, subject disposition events and substance use

    * denotes new contents added to the 2024-04-02 releases

    Section
    bordertrue
    Column

    Status
    colourYellow
    titleUpdated
    Included in the 2024-04-02 releases are:

    Enhancements

    Feature

    • In addition to the Controlled Terminology Codelist Code, CDISC CT Codelist Submission Values are available in the exports and API for all SEND Implementation Guides, all ADaM Implementation Guides, and CDASHIG v2.3.

    Contents

    • 2024 Q1 CT package (P57, dated 2024-03-29): ADaM CT, DDF CT, Define-XML CT, MRCT CT, Protocol CT, SDTM CT, SEND CT.
    • CDISC BC & SDTM Specialization Package 7.

    Data Standards Browser

    • N/A for this release.

    Corrections & Patches

    • N/A for this release.

    Deprecations

    • N/A for this release.


    Expand
    titleReview information from previous release notes...

    Enhancements

    Feature

    • N/A

    Contents

    • ADaM popPK v1.0, promoted from Draft Content to Final
    • CDASH Model v1.3 and CDASHIG v2.3, promoted from Draft Content to Final
    • CDISC BC & SDTM Specialization Packages 5 & 6

    Data Standards Browser

    • N/A for this release.

    Corrections & Patches

    • N/A for this release.

    Deprecations

    • N/A for this release.
    Section
    bordertrue
    Column

    For system maintenance status, use this endpoint to obtain a flag indicating whether CDISC Library is under maintenance and a related system message:

    Code Block
    linenumberstrue
    /mdr/maintenance

    For example,

    Code Block
    linenumberstrue
    {
      "maintenanceMode": true,
      "maintenanceMessage": "CDISC Library is currently under a scheduled maintenance."
    }
    Section
    bordertrue
    Column

    For a machine-readable method to obtain a full listing of products loaded into the metadata repository use:

    Code Block
    linenumberstrue
    /mdr/products

    Or, by product group:

    Code Block
    firstline2
    linenumberstrue
    /mdr/products/{product-group}

    where product-group is one of these values:

    • Terminology
    • DataCollection
    • DataTabulation
    • DataAnalysis
    • DraftContent*

    * denotes new parameter added as of the 2021-03-30 release

    For system maintenance status, use this endpoint to obtain a flag indicating whether CDISC Library is under maintenance and a related system message:

    Section
    bordertrue
    Column

    Included in the 2020-02-14 release are two new endpoints, designed to provide high-level information about CDISC Library. These endpoints support both JSON and XML media types.

    First, /mdr/about returns the URL for on-line API Documentation and Release Notes. It also includes a hypermedia link to a list of the product groups with their most recent update dates, as described below.

    Code Block
    linenumberstrue
    /mdr/about

    /mdr/lastupdated returns dates of last updated, organized by CDISC product group.

    Code Block
    linenumberstrue
    /mdr/lastupdated

    For example:

    Code Block
    title/mdr/about example output
    linenumberstrue
    {
      "_links": {
        "self": {
          "href": "/mdr/about",
          "title": "Information About CDISC Library",
          "type": "About CDISC Library"
        },
        "lastupdated
    Column
    Code Block
    linenumberstrue
    /mdr/maintenance

    For example,

    Code Block
    linenumberstrue
    {
      "maintenanceMode": true,
      "maintenanceMessage": "CDISC Library is currently under a scheduled maintenance."
    }
    Section
    bordertrue
    Column

    For a machine-readable method to obtain a full listing of products loaded into the metadata repository use:

    Code Block
    linenumberstrue
    /mdr/products

    Or, by product group:

    Code Block
    firstline2
    linenumberstrue
    /mdr/products/{product-group}

    where product-group is one of these values:

    • Terminology
    • DataCollection
    • DataTabulation
    • DataAnalysis
    • DraftContent*

    * denotes new parameter added as of the 2021-03-30 release

    Section
    bordertrue
    Column

    Included in the 2020-02-14 release are two new endpoints, designed to provide high-level information about CDISC Library. These endpoints support both JSON and XML media types.

    First, /mdr/about returns the URL for on-line API Documentation and Release Notes. It also includes a hypermedia link to a list of the product groups with their most recent update dates, as described below.

    Code Block
    linenumberstrue
    /mdr/about

    /mdr/lastupdated returns dates of last updated, organized by CDISC product group.

    Code Block
    linenumberstrue
    /mdr/lastupdated

    For example:

    Code Block
    title/mdr/about example output
    linenumberstrue
    {
      "_links": {
        "self": {
          "href": "/mdr/about",
          "title": "Information About CDISC Library",
          "type": "About CDISC Library"
        },
        "lastupdated": {
          "href": "/mdr/lastupdated",
          "title": "Last Update Date of CDISC Library Products",
          "type": "About CDISC Library"
        }
      },
      "release-notes": "https://wiki.cdisc.org/display/LIBSUPRT/Release+Notes",
      "api-documentation": "https://www.cdisc.org/cdisc-library/api-documentation"
    }
    Code Block
    title/mdr/lastupdated example output
    linenumberstrue
    {
      "_links": {
        "self": {
          "href": "/mdr/lastupdated",
          "title": "Last Update Date of CDISC Library Products",
          "type": "About CDISC Library"
        }
      },
      "overallrelease-notes": "2020-02-14"https://wiki.cdisc.org/display/LIBSUPRT/Release+Notes",
      "dataapi-analysisdocumentation": "https://www.cdisc.org/cdisc-library/api-documentation"
    }
    Code Block
    title/mdr/lastupdated example output
    linenumberstrue
    {2020-02-14",
      "data-collection_links": "2020-02-14",
      "data-tabulation": "2019-11-18",
      "terminology": "2020-02-14"
    }
    Section

    Media Type

     {
        "self": {
          "href": "/mdr/lastupdated",
          "title": "Last Update Date of CDISC Library Products",
          "type": "About CDISC Library"
        }
      },
      "overall": "2020-02-14",
      "data-analysis": "2020-02-14",
      "data-collection": "2020-02-14",
      "data-tabulation": "2019-11-18",
      "terminology": "2020-02-14"
    }
    Section

    Media Type

    Section
    bordertrue
    Column

    Added to the 2021-06-28 release is the support for ODM-XML, as a beta functionality. The media type for ODM-XML is application/odm+xml. For CDASHIG, users will receive an ODM v1.3.2 document as the response payload. For ADaMIG, SDTMIG, and SENDIG, user will receive a Define-XML v2.1 document.

    Note

    ODM-XML, CSV and Excel Workbook media types are only available at the top-level of a foundational standard. When requesting them at levels in any lower hierarchy, the API will return an HTTP 406 Not Acceptable status code.

    CDISC Controlled Terminology in ODM-XML format is not yet supported. This is currently accessible through NCI EVS FTP site, here: https://evs.nci.nih.gov/ftp1/CDISC.

    For example, a cURL snippet to obtain ADaM OCCDS v1.0 (lines #1-3), SDTMIG v3.3 (lines #5-7) in ODM format. The outputs are in Define-XML v2.1:

    Code Block
    languagetext
    linenumberstrue
    curl -X 
    Section
    bordertrue
    Column

    Added to the 2019-07-18 release is the support for two additional media types: CSV and Excel. Users may request top-level foundational standards exports in either CSV or Excel Workbook format. The media type for CSV is text/csv, while application/vnd.ms-excel for Excel.

    Note

    CSV and Excel Workbook media types are only available at the top-level of a foundational standard. When requesting them at levels in any lower hierarchy, the API will return an HTTP 406 Not Acceptable status code.

    Info

    Refer to Limitations for an important note about the CSV and Excel exports.

    For example, a cURL snippet to obtain ADaM OCCDS v1.0 (lines #1-3), SDTMIG v3.3 (lines #5-7), and Controlled Terminology P38 (lines #9-11) in CSV format:

    Code Block
    languagetext
    linenumberstrue
    curl -X GET \
      https://library.cdisc.org/api/mdr/adam/adam-occds-1-0 \
      -H 'Accept: text/csv'
    
    curl -X GET \
      https://library.cdisc.org/api/mdr/sdtmig/3-3adam/adam-occds-1-0 \
      -H 'Accept: textapplication/csvodm+xml'
    
    
    curl -X GET \
      https://library.cdisc.org/api/mdr/ctsdtmig/packages/sdtmct-2019-06-283-3 \
      -H 'Accept: textapplication/csvodm+xml'
    
    Similarly, a

    Another cURL snippet to obtain

    ADaM OCCDS v1.0 (lines #1-3) , SDTMIG v3.3 (lines #5-7), and Controlled Terminology P38 (lines #9-11) in Excel Workbook format

    CDASHIG v2.1 in ODM format. The output is in ODM v1.3.2:

    Code Block
    languagetext
    linenumberstrue
    curl -X GET \
      https://library.cdisc.org/api/mdr/adamcdashig/adam-occds2-1-0 \
      -H 'Accept: application/odm+xml'
    

    Below is a cURL snippet to obtain ADaM OCCDS v1.0 (lines #1-3), SDTMIG v3.3 (lines #5-7), and Controlled Terminology P38 (lines #9-11) in CSV format:

    Code Block
    languagetext
    linenumberstrue
    vnd.ms-excel'
    
    curl -X GET \
      https://library.cdisc.org/api/mdr/sdtmig/3-3adam/adam-occds-1-0 \
      -H 'Accept: application/vnd.ms-excel'
    text/csv'
    
    curl -X GET \
      https://library.cdisc.org/api/mdr/sdtmig/3-3 \
      -H 'Accept: text/csv'
    
    curl -X GET \
      https://library.cdisc.org/api/mdr/ct/packages/sdtmct-2019-06-28 \
      -H 'Accept: application/vnd.ms-excel'
    Section
    bordertrue
    text/csv'

    Similarly, a cURL snippet to obtain ADaM OCCDS v1.0 (lines #1-3) , SDTMIG v3.3 (lines #5-7), and Controlled Terminology P38 (lines #9-11) in Excel Workbook format:

    Code Block
    languagetext
    linenumberstrue
    curl -X GET \
      https://library.cdisc.org/api/mdr/adam/adam-occds-1-0 \
      -H 'Accept: application/vnd.ms-excel'
    
    
    Column

    Added to the 2019-04-10 release is the XML media type, as a beta functionality. Users may now specify either JSON and XML to be the formatted API response. For example, a cURL snippet to obtain a list of content loaded in the metadata repository as JSON (lines #1-3) vs. XML (lines #5-7):

    Code Block
    languagetext
    linenumberstrue
    curl -X GET \
      https://library.cdisc.org/api/mdr/sdtmig/products3-3 \
      -H 'Accept: application/jsonvnd.ms-excel'
    
    curl -X GET \
      https://library.cdisc.org/api/mdr/products/mdr/ct/packages/sdtmct-2019-06-28 \
      -H 'Accept: application/xml'vnd.ms-excel'
    Section

    Draft Contents

    Section
    bordertrue
    Column

    Starting 2021-03-30, users can access draft contents through CDISC Library. Draft contents are point-in-time snapshots, before they become official publication. Although may not be suitable for production use, draft contents are helpful toward evaluation and public reviewsFor input and suggestions about the XML media type beta functionality, please use the CDISC Library Product Inquiry form.

    Section

    Controlled Terminology

    ...

    Section
    bordertrue
    Column

    The CDASH products include different types of mappings:

    • CDASH model class variables to SDTM class variables
    • CDASH model class variables to SDTM dataset variables
    • CDASH model domain variables to SDTM dataset variables
    • CDASH model domain variables to SDTMIG dataset variables
    • CDASHIG domain fields to SDTMIG dataset variables
    • CDASHIG domain fields to SDTM class variables
    • CDASHIG scenario fields to SDTMIG dataset variables

    To accommodate the different types of mapping targets, three JSON array attributes had to be defined:, three JSON array attributes had to be defined:

    • sdtmClassMappingTargets
    • sdtmDatasetMappingTargets
    • sdtmigDatasetMappingTargets
    Section
    bordertrue
    Column

    For CDASH Model v1.2 and CDASHIG v2.2, where applicable:

    • Class description is added using definitions from CDISC CT.
    • Domain description is added using definitions from CDISC CT.
    • Class name is adjusted from "Findings About" to "Findings about Events and Interventions" to match source content, i.e., CDISC Wiki space.
    • sdtmClassMappingTargets
    • sdtmDatasetMappingTargets
    • sdtmigDatasetMappingTargets
    Section

    SDTM

    Section
    bordertrue
    Column

    Variables in the SDTM occasionally have expanded text to describe a variable's role. This text is stored in "roleDescription" in the metadata repository. Otherwise, "roleDescription" matches "role", where "role" has a set of controlled values. Below is an example for the SDTM v1.5 variable SVUPDES:

    Code Block
    linenumberstrue
    "ordinal": "11", 
    "name": "SVUPDES", 
    "label": "Description of Unplanned Visit", 
    "description": "Description of what happened to the subject during an unplanned visit. Null for protocol-defined visits.", 
    "role": "Qualifier", 
    "roleDescription": "Optional Qualifier", 
    ...

    ...