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

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.

/mdr/products/{product-family}

where product-family is one of these values:

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.

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

• 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

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.

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

/mdr/maintenance

For example,

{
  "maintenanceMode": true,
  "maintenanceMessage": "CDISC Library is currently under a scheduled maintenance."
}

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

/mdr/products

Or, by product group:

/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

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.

/mdr/about

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

/mdr/lastupdated

For example:

{
  "_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"
}

{
  "_links": {
    "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"
}

CDISC finished updating all internal (meta-model, URIs, etc.) and textual references of SHARE to CDISC Library. The base URL and API interface remain unaffected. User will find this update mostly in the value of _link/self/title and _links/self/label. For example:

{
  "_links": {
    "self": {
      "href": "/mdr/products",
      "title": "CDISC Library Product List",
      "type": "CDISC Library Product List"
    },
  ...
}

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.

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