You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 10 Next »

News and updates

  • 2023-12-12: Package 6 (package 2023-12-12)
  • 2023-10-03: Package 5 (package 2023-10-03), new endpoints added to API v2
  • 2023-07-06: Package 4 (package 2023-07-06), new versioned APIs
  • 2023-04-04: Package 3 (package 2023-03-31)
  • 2023-02-13: Package 2 (package 2023-02-13)
  • 2022-12-07: Initial version (package 2022-10-26)

Release Notes 2023-12-12

New CDISC Biomedical Concepts (BCs) and SDTM Dataset Specializations (package 6) are now available in the CDISC Library.  These were developed to support the Digital Data Flow (DDF) pilot study and to continue the expansion of BCs and SDTM Dataset Specializations in the CDISC Library:

  • New BCs include laboratory tests, inclusion/exclusion criteria, medical history, medical procedures, product administration, subject characteristics, subject disposition events and substance use
  • New SDTM Dataset Specializations cover multiple domains including DS, EC, EX, IE, LB, MH, PR, SC, and SU

In addition, a number of enhancements were made to existing content. CDISC Library now contains a total of 248 BCs and 227 SDTM Dataset Specializations retrievable via the CDISC Library API. Refer to Basic Construct section for endpoints marked new.

New Excel exports of the latest versions BCs and SDTM Dataset Specialization from CDISC Library are now available at COSMoS Documentation.

Changes to API Endpoint Responses for CDISC Biomedical Concepts and SDTM Dataset Specializations

API endpoint responses for CDISC Biomedical Concepts and SDTM Dataset Specializations have changed due to the evolution of the Biomedical Concepts data model. As a result, all API endpoints will be versioned. The original, pre-existing API endpoints will remain available in API  v1.

New API endpoints have been developed and are available in API v2. On July 6, 2023, all new and revised API endpoints for CDISC Biomedical Concepts and SDTM Dataset Specializations will be included in API v2.

Starting July 6, 2023, all API requests will need to include a version. For example,

Old API endpoint:

/mdr/bc/packages/2022-10-26/biomedicalconcepts/C64547

New API endpoints

/cosmos/v1/mdr/bc/packages/2022-10-26/biomedicalconcepts/C64547
/cosmos/v2/mdr/bc/packages/2022-10-26/biomedicalconcepts/C64547

A version must be specified. If a user does not specify a version, a 404 API response code (Not Found) will be returned. All documentation for the CDISC Library API can be found at https://api.developer.library.cdisc.org/. Users should use their existing cdiscID login credentials.

Introduction

CDISC biomedical concepts and dataset specializations are currently supported standards. These include an abstract conceptual layer, aligned with NCI terminology, which is linked to a simplified implementation layer of pre-configured SDTM dataset specializations. Information for additional specializations, such as CDASH data collections, will be added when they become available. 

The biomedical concepts and dataset specializations are informative content. They will start to fill gaps such as semantics, variable relationships and value level metadata. Key objectives are to reduce variability in standards implementations, increase metadata-driven automation and reduce barriers to operational implementation. 

CDISC biomedical concepts and dataset specializations will be released in incremental packages. The first package was released on October 26, 2022.  Subsequent packages have been released and are now available via CDISC Library APIs (see News and Updates).

Please use CDISC Jira for comments and feedback.

Base URL for API Endpoints

The base URL for the API is:

https://library.cdisc.org/api/cosmos/v2

Or, this one for legacy support:

https://library.cdisc.org/api/cosmos/v1

Note that there has not been a target sunset date established yet.

Model & Schema

The model and schema describing the CDISC biomedical concepts and SDTM dataset specializations can be found on GitHub.

Basic Construct

UPDATED

The following table shows the basic construct of API requests to obtain biomedical concepts:

API request templateAPI v2 Only?Return Latest Version Only?Description

/mdr/bc/packages



Get Biomedical Concept Package List

/mdr/bc/packages/{package}/biomedicalconcepts



Get Biomedical Concept List in a Package (example)

/mdr/bc/packages/{package}/biomedicalconcepts/{biomedicalconcept}



Get Biomedical Concept in a Package (example)

/mdr/bc/biomedicalconcepts NEW ENDPOINT

(tick)

(tick)

Get Biomedical Concept List (example)

/mdr/bc/biomedicalconcepts/{biomedicalconcept} NEW ENDPOINT

(tick)

(tick)

Get Biomedical Concept (example)

/mdr/bc/categories NEW ENDPOINT

(tick)


Get Biomedical Concept Categories List (example)

/mdr/bc/biomedicalconcepts?category={category} NEW ENDPOINT

(tick)

(tick)

Get List of Biomedical Concepts for a Given Category (example)

The following table shows the basic construct of API requests to obtain SDTM dataset specializations:

API request templateAPI v2 Only?Return Latest Version Only?Description

/mdr/specializations/sdtm/packages



Get SDTM Dataset Specialization Package List

/mdr/specializations/sdtm/packages/{package}/datasetspecializations



Get SDTM Dataset Specialization List in a Package (example)

/mdr/specializations/sdtm/packages/{package}/datasetspecializations/{datasetspecialization}



Get SDTM Dataset Specialization in a Package (example)

/mdr/specializations/sdtm/datasetspecializations NEW ENDPOINT

(tick)

(tick)

Get SDTM Dataset Specialization List (example)

/mdr/specializations/sdtm/datasetspecializations/{datasetspecialization} NEW ENDPOINT

(tick) (tick) Get SDTM Dataset Specialization (example)

/mdr/specializations/sdtm/domains NEW ENDPOINT

(tick)
Get SDTM Dataset Specialization Domain List (example)

/mdr/specializations/sdtm/datasetspecializations?domain={domain} NEW ENDPOINT

(tick)

(tick)

Get a List of SDTM Dataset Specializations for a Given Domain (example)

The following table shows the basic construct of API requests to obtain dataset specializations:

API request templateAPI v2 Only?Return Latest Version Only?Description

/mdr/specializations/datasetspecializations?biomedicalconcept={biomedicalconcept} NEW ENDPOINT

(tick) (tick) Get a List of Dataset Specializations that Specialize a Biomedical Concept (example)

This is a table of supported parameters:

ParameterDescription
packagePackage Identifier. An ISO 8601 date.
biomedicalconceptBiomedical Concept Identifier. A string.
datasetspecializationSDTM Dataset Specialization Identifier. A string.
categoryBiomedical Concept Category. A string.
domainIdentifier for Dataset Specialization Domain. Examples: AE, DM, VS. A string.

Core Differences in BC API v2

These are the changes in the response payload from /mdr/bc/packages/{package}/biomedicalconcepts/{biomedicalconcept}:

  • Attribute name changes
    • $.category to $.categories
    • $.synonym to $.synonyms
    • $.resultScale to $.resultScales
  • Data type changes
    • $.resultScales returns from a scalar to a list
  • New attributes
    • $.ncitCode
    • $.dataElementConcepts.ncitCode

Some examples are slightly modified to provide a better visual and flow. The examples are reflective of v2 endpoints.

The JSON standard defines an object as "an unordered collection of zero or more name/value pairs". As such, the specific order in which object keys appear may vary in the response payload.

Example 1

Get the biomedical concept list from the package released on October 26, 2022.

/mdr/bc/packages/2022-10-26/biomedicalconcepts

{
    "_links": {
        "biomedicalConcepts": [
            {
                "href": "/mdr/bc/packages/2022-10-26/biomedicalconcepts/C25298",
                "title": "Systolic Blood Pressure",
                "type": "Biomedical Concept"
            },
            ...
         ],
         "self": {
            "href": "/mdr/bc/packages/2022-10-26/biomedicalconcepts",
            "title": "Biomedical Concepts",
            "type": "Biomedical Concept List"
        }
    },

Lines 3-10: A list of HATEOS links to biomedical concepts matching the package parameter, excerpted to show Systolic Blood Pressure.
Each biomedical concept has 3 elements: href, title, and type.

For an in-depth explanation of HATEOS refer to In-depth: HATEOAS Implementation in CDISC Library API for more information about hypermedia links.

    "effectiveDate": "2022-10-26",
    "label": "Biomedical Concept Package Effective 2022-10-26",
    "name": "Biomedical Concepts 2022-10-26",
    "version": "2022-10-26"
}
Lines 17-20: Metadata about the biomedical concept list.

Example 2

Get the one Systolic Blood Pressure biomedical concept from the package released on October 26, 2022.

/mdr/bc/packages/2022-10-26/biomedicalconcepts/C25298

{
    "_links": {
        "parentBiomedicalConcept": {
            "href": "/mdr/bc/packages/2022-10-26/biomedicalconcepts/C54706",
            "title": "Blood Pressure",
            "type": "Biomedical Concept"
        },
        "parentPackage": {
            "href": "/mdr/bc/packages/2022-10-26/biomedicalconcepts",
            "title": "Biomedical Concept Package Effective 2022-10-26",
            "type": "Biomedical Concept Package"
        },
        "self": {
            "href": "/mdr/bc/packages/2022-10-26/biomedicalconcepts/C25298",
            "title": "Systolic Blood Pressure",
            "type": "Biomedical Concept"
        }
    },

Lines 2-18: A list of HATEOAS links to related resources, such as self, parent package, and parent biomedical concept. A note on parent biomedical concept: In this example, Blood Pressure is the parent to Systolic Blood Pressure. parentBiomedicalConcept will not be present for topmost biomedical concepts.

Lines 3-7: The latest version of the parent biomedical concept (Blood Pressure).

     "categories": [
        "Vital Signs"
    ],
Lines 19-21: A list of categories to which this biomedical concept belongs.
    "coding": [
        {
            "code": "8480-6",
            "system": "http://loinc.org/",
            "systemName": "LOINC"
        }
    ],
Lines 22-28: A list of external code systems to which this biomedical concept relates.
    "dataElementConcepts": [
        {
            "conceptId": "C173522",
            "dataType": "integer",
            "href": "https://ncithesaurus.nci.nih.gov/...&code=C173522",
            "ncitCode": "C173522",
            "shortName": "Vital Signs Result"
        },
        {
            "conceptId": "C49669",
            "dataType": "string",
            "exampleSet": [
                "cmHg",
                "mmHG",
                "Pascal"
            ],
            "href": "https://ncithesaurus.nci.nih.gov/...&code=C49669",
            "ncitCode": "C49669",
            "shortName": "Unit of Pressure"
        },
        ...
    ],

Lines 29-50: A list of data element concepts that comprise this biomedical concept. The href value points to an NCI EVS Thesaurus resource where definition of this data element can be found via the concept code (or, commonly known as c-code).

Lines 31-35: Vital Signs Result (Line 35) is the first data element concept on the list.

Lines 38-47: Unit of Measure (Line 47) is the next data element concept on the list. An example set of values is provided in this example.

    "conceptId": "C25298",
    "definition": "The maximum pressure exerted into the systemic arterial...",
    "href": "https://ncithesaurus.nci.nih.gov/...&code=C25298",
    "resultScales": [
        "Quantitative
    ],
    "ncitCode": "C25298",
    "shortName": "Systolic Blood Pressure",
    "synonyms": [
        "SYSBP"
    ]
}
Lines 51-61: Metadata about the biomedical concept.

Example 3

NEW

Get a list of all biomedical concepts across packages.

/mdr/bc/biomedicalconcepts

{
    "_links": {
        "biomedicalConcepts": [
            {
                "href": "/mdr/bc/biomedicalconcepts/C25298",
                "title": "Systolic Blood Pressure",
                "type": "Biomedical Concept"
            },
            ...
        ],
        "self": {
            "href": "/mdr/bc/biomedicalconcepts",
            "title": "Biomedical Concepts (latest version)",
            "type": "Biomedical Concept List"
        }
    }, 
    "name": "Biomedical Concepts (latest version)",
    "label": "Biomedical Concepts List"
}

Lines 3-10: A list of HATEOS links to biomedical concepts, excerpted to show Systolic Blood Pressure.
Each biomedical concept has 3 elements: href, title, and type.

For an in-depth explanation of HATEOS refer to In-depth: HATEOAS Implementation in CDISC Library API for more information about hypermedia links.

Example 4

NEW

Get the latest version of the Systolic Blood Pressure biomedical concept.

/mdr/bc/biomedicalconcepts/C25298

{
    "_links": {
        "parentBiomedicalConcept": {
            "href": "/mdr/bc/biomedicalconcepts/C54706",
            "title": "Blood Pressure",
            "type": "Biomedical Concept"
        },
        "parentPackage": {
            "href": "/mdr/bc/packages/2023-07-06/biomedicalconcepts",
            "title": "Biomedical Concept Package Effective 2023-07-06",
            "type": "Biomedical Concept Package"
        },
        "self": {
            "href": "/mdr/bc/biomedicalconcepts/C25298",
            "title": "Systolic Blood Pressure",
            "type": "Biomedical Concept"
        }
    },
Lines 2-18: A list of  HATEOAS  links to related resources, such as self, parent package that has the latest version of this biomedical concept, and parent biomedical concept. A note on parent biomedical concept: In this example, Blood Pressure is the parent to Systolic Blood Pressure.  parentBiomedicalConcept  will not be present for topmost biomedical concepts.
"categories": [
    "Vital Signs"
],
Lines 19-21: A list of categories to which this biomedical concept belongs.
"coding": [
    {
        "code": "8480-6",
        "system": "http://loinc.org/",
        "systemName": "LOINC"
    }
],
Lines 22-28: A list of external code systems to which this biomedical concept relates.
"dataElementConcepts": [
       {
           "conceptId": "C173522",
           "dataType": "decimal",
           "href": "https://ncithesaurus.nci.nih.gov/...&code=C173522",
           "ncitCode": "C173522",
           "shortName": "Vital Signs Result"
       },
       {
           "conceptId": "C49669",
           "dataType": "string",
           "exampleSet": [
               "cmHg",
               "mmHG",
               "Pascal"
           ],
           "href": "https://ncithesaurus.nci.nih.gov/...&code=C49669",
           "ncitCode": "C49669",
           "shortName": "Unit of Pressure"
       },
       ...
   ],

Lines 29-50: A list of data element concepts that comprise this biomedical concept. The href value points to an NCI EVS Thesaurus resource where definition of this data element can be found via the concept code (or, commonly known as c-code).

Lines 31-35: Vital Signs Result (Line 35) is the first data element concept on the list. 

Lines 38-47: Unit of Measure (Line 47) is the next data element concept on the list. An example set of values is provided in this example.

51
    "conceptId": "C25298",
    "definition": "The maximum pressure exerted into the systemic arterial...",
    "href": "https://ncithesaurus.nci.nih.gov/...&code=C25298",
    "resultScales": [
        "Quantitative
    ],
    "ncitCode": "C25298",
    "shortName": "Systolic Blood Pressure",
    "synonyms": [
        "SYSBP"
    ]
}
Lines 51-61: Metadata about the biomedical concept.

Example 5

NEW

Get a list of all the biomedical concept categories.

/mdr/bc/categories

{
    "_links": {          
         "self": {
             "href": "/mdr/bc/categories",
             "title": "Biomedical Concept Categories",
             "type": "Biomedical Concept Category List"
         }
         "categories": [
            {
                "name": "Vital Signs",
                "_links": {
                    "self": {
                        "href": "/mdr/bc/biomedicalconcepts?category=Vital%20Signs",
                        "title": "Biomedical Concepts Category (Vital Signs)",
                        "type": "Biomedical Concepts Category"
                    }
                }
            },
            ...
        ],
     },
    "name": "Biomedical Concept Categories",
    "label": "Biomedical Concept Categories List"
}

Lines 8-20: A list of HATEOS links to biomedical concept categories, excerpted to show Vital Signs.
Each biomedical concept category has 3 elements: href, title, and type.

For an in-depth explanation of HATEOS refer to In-depth: HATEOAS Implementation in CDISC Library API for more information about hypermedia links.

Example 6

NEW

Get a list of the latest version of all biomedical concepts in the Vital Signs category.

/mdr/bc/biomedicalconcepts?category=Vital%20Signs

{
    "_links": {
        "biomedicalConcepts": [
            {
                "href": "/mdr/bc/biomedicalconcepts/C25298",
                "title": "Systolic Blood Pressure",
                "type": "Biomedical Concept"
            },
            ...
        ],
        "self": {
            "href": "/mdr/bc/biomedicalconcepts",
            "title": "Biomedical Concepts (latest version)",
            "type": "Biomedical Concept List"
        }
    },

Lines 3-10: A list of HATEOS links to biomedical concepts in the Vital Signs category, excerpted to show Systolic Blood Pressure.
Each biomedical concept has 3 elements: href, title, and type.

For an in-depth explanation of HATEOS refer to In-depth: HATEOAS Implementation in CDISC Library API for more information about hypermedia links.

    "name": "Biomedical Concepts (latest version)",
    "category": "Vital Signs",
    "label": "Biomedical Concepts List"
} 
Lines 17-20: Metadata about the biomedical concept category list.

Example 7

NEW

Get the SDTM dataset specialization list from the package released on October 26, 2022.

/mdr/specializations/sdtm/packages/2022-10-26/datasetspecializations

{
    "_links": {
        "self": {
            "href": "/mdr/specializations/sdtm/...datasetspecializations",
            "title": "SDTM Dataset Specializations",
            "type": "SDTM Dataset Specialization list"
        },
        "datasetSpecializations": [
            {
                "href": "/mdr/specializations/sdtm/...datasetspecializations/SYSBP",
                "title": "Systolic Blood Pressure",
                "type": "SDTM Dataset Specialization"
            },
            ...
        ]
    },
Lines 8-15: A list of SDTM dataset specializations matching the package parameter, excerpted to show Systolic Blood Pressure. Note the specialization type is set to "SDTM Dataset Specialization".
    "effectiveDate": "2022-10-26",
    "label": "SDTM Dataset Specialization Package Effective 2022-10-26",
    "name": "SDTM Dataset Specializations 2022-10-26",
    "version": "2022-10-26"
}
Lines 17-20: Metadata about the SDTM dataset specialization list.

Example 8

Get the one Systolic Blood Pressure SDTM dataset specialization from the package released on October 26, 2022.

/mdr/specializations/sdtm/packages/2022-10-26/datasetspecializations/SYSBP

{
    "_links": {
        "parentBiomedicalConcept": {
            "href": "/mdr/bc/packages/2022-10-26/biomedicalconcepts/C25298",
            "title": "Systolic Blood Pressure",
            "type": "Biomedical Concept"
        },
        "parentPackage": {
            "href": "/mdr/specializations/sdtm/...datasetspecializations",
            "title": "SDTM Dataset Specialization Package Effective 2022-10-26",
            "type": "SDTM Dataset Specialization Package"
        },
        "self": {
            "href": "/mdr/specializations/sdtm/...datasetspecializations/SYSBP",
            "title": "Systolic Blood Pressure",
            "type": "SDTM Dataset Specialization"
        }
    },
Lines 2-18: A list of HATEOAS links to related resources, such as self, parent package, and parent biomedical concept. A note on parent biomedical concept: In this example, Systolic Blood Pressure is the parent biomedical concept to this SDTM dataset specialization.  parentBiomedicalConcept  will not be present if no parent is available at the time of publication.
    "variables": [
        {
            "name": "VSORRESU",
            "dataElementConceptId": "C49669",
            "isNonStandard": false,
            "mandatoryValue": false,
            "mandatoryVariable": true,
            "role": "Qualifier",
            "relationship": {
                "linkingPhrase": "is the unit for the value in",
                "object": "VSORRES",
                "predicateTerm": "IS_UNIT_FOR",
                "subject": "VSORRESU"
            },
            "codelist": {
                "conceptId": "C66770",
                "href": "https://ncithesaurus.nci.nih.gov/...&code=C66770",
                "submissionValue": "VSRESU"
            },
            "assignedTerm": {
                "conceptId": "C49670",
                "value": "mmHG"
            },
            "vlmTarget": true
        },

Line 19: Beginning of a variable (or, data element) list that comprise this Systolic Blood Pressure SDTM dataset specialization.

Lines 20-43: VSORRESU (Line 21) is the first variable on the list. codelist (Lines 33-37) shows controlled terminology metadata for this variable. relationship (Lines 27-32) shows how this variable is related to another variable in the format of (subject, predicate, object): VSORRESU IS_UNIT_FOR VSORRES.

        {
            "name": "VSSTRESN",
            "dataElementConceptId": "C173522",
            "isNonStandard": false,
            "dataType": "integer",
            "length": 3,
            "mandatoryValue": false,
            "mandatoryVariable": false,
            "role": "Qualifier",
            "relationship": {
                "linkingPhrase": "is the result of the test in",
                "object": "VSTESTCD",
                "predicateTerm": "IS_RESULT_OF",
                "subject": "VSSTRESN"
            },
            "vlmTarget": true
        },
        ...
    ],

Lines 44-60: VSSTRESN (Line 45) is the next variable on the list. It has an integer as datatype with a preconfigured length of 3. relationship (Lines 53-58) shows how this variable is related to another variable in the format of (subject, predicate, object): VSSTRESN IS_RESULT_OF VSTESTCD.

    "datasetSpecializationId": "SYSBP",
    "domain": "VS",
    "sdtmigStartVersion": "3-2",
    "shortName": "Systolic Blood Pressure",
    "source": "VS.VSTESTCD"
}
Lines 63-67: Metadata about the SDTM dataset specialization.

Example 9

NEW

Get a list of all SDTM dataset specializations across packages.

/mdr/specializations/sdtm/datasetspecializations

{
    "_links": {
        "datasetSpecializations": [
            {
                "href": "/mdr/specializations/sdtm/datasetspecializations/SYSBP",
                "title": "Systolic Blood Pressure",
                "type": "SDTM Dataset Specialization"
            },
            ...
        ],
        "self": {
            "href": "/mdr/specializations/sdtm/datasetspecializations",
            "title": "SDTM Dataset Specializations (latest version)",
            "type": "SDTM Dataset Specializations List"
        }
    },
    "name": "SDTM Dataset Specializations (latest version)",
    "label": "SDTM Dataset Specializations List"
}

Lines 3-10: A list of SDTM dataset specializations, excerpted to show Systolic Blood Pressure.
Each SDTM dataset specialization has 3 elements: href, title, and type. For Refer to In-depth: HATEOAS Implementation in CDISC Library API for more information about hypermedia links.

Example 10

NEW

Get the latest version of the Systolic Blood Pressure SDTM Dataset Specialization.

/mdr/specializations/sdtm/datasetspecializations/SYSBP

{
    "_links": {
        "parentBiomedicalConcept": {
            "href": "/mdr/bc/biomedicalconcepts/C25298",
            "title": "Systolic Blood Pressure",
            "type": "Biomedical Concept"
        },
        "parentPackage": {
            "href": "/mdr/specializations/sdtm/packages/2023-07-06/datasetspecializations",
            "title": "SDTM Dataset Specialization Package Effective 2023-07-06",
            "type": "SDTM Dataset Specialization Package"
        },
        "self": {
            "href": "/mdr/specializations/sdtm/datasetspecializations/SYSBP",
            "title": "Systolic Blood Pressure",
            "type": "SDTM Dataset Specialization"
        }
    },

Lines 2-18: A list of HATEOAS links to related resources, such as self, parent package, and parent biomedical concept. A note on parent biomedical concept: In this example, Systolic Blood Pressure is the parent biomedical concept to this SDTM dataset specialization.  parentBiomedicalConcept  will not be present if no parent is available at the time of publication.
    "variables": [
        ...
        {
            "name": "VSORRESU",
            "dateElementConceptId": "C49669",
            "isNonStandard": false,
            "codelist": {
                "conceptId": "C66770",
                "submissionValue": "VSRESU",
                "href": "https://ncithesaurus.nci.nih.gov/...&code=C66770"
            },
            "assignedTerm": {
                "conceptId": "C49670",
                "value": "mmHg"
            },
            "role": "Qualifier",
            "relationship": {
                "subject": "VSORRESU",
                "linkingPhrase": "is the unit for the value in",
                "predicateTerm": "IS_UNIT_FOR",
                "object": "VSORRES"
            },
            "mandatoryVariable": true,
            "mandatoryValue": false,
            "vlmTarget": true
        },

Line 19: Beginning of a variable (or, data element) list that comprise this Systolic Blood Pressure SDTM dataset specialization.

Lines 21-44: VSORRESU (Line 21) is a variable on the list. codelist (Lines 33-37) shows controlled terminology metadata for this variable. relationship (Lines 27-32) shows how this variable is related to another variable in the format of (subject, predicate, object): VSORRESU IS_UNIT_FOR VSORRES.

        {
            "name": "VSSTRESN",
            "dateElementConceptId": "C173522",
            "isNonStandard": false,
            "role": "Qualifier",
            "dataType": "integer",
            "length": 3,
            "relationship": {
                "subject": "VSSTRESN",
                "linkingPhrase": "is the result of the test in",
                "predicateTerm": "IS_RESULT_OF",
                "object": "VSTESTCD"
            },
            "mandatoryVariable": false,
            "mandatoryValue": false,
            "vlmTarget": true
        },
        ...
],
Lines 45-61: VSSTRESN (Line 45) is the next variable on the list. It has an integer as datatype with a preconfigured length of 3. relationship (Lines 53-58) shows how this variable is related to another variable in the format of (subject, predicate, object): VSSTRESN IS_RESULT_OF VSTESTCD.
    "datasetSpecializationId": "SYSBP",
    "domain": "VS",
    "sdtmigStartVersion": "3-2",
    "sdtmigEndVersion": "",
    "shortName": "Systolic Blood Pressure",
    "source": "VS.VSTESTCD"
}
Lines 64-70: Metadata about the SDTM dataset specialization.

Example 11

NEW

Get a list of all the SDTM dataset specialization domains.

/mdr/specializations/sdtm/domains

{
    "_links": {
        "self": {
            "href": "/mdr/specializations/sdtm/domains",
            "title": "SDTM Dataset Specializations Domains",
            "type": "SDTM Dataset Specializations Domains List"
        }
    "domains": [
        {
             "name": "VS"
             "_links": {
                "self": {
                    "href": "/mdr/specializations/sdtm/datasetspecializations?domain=VS",
                    "title": "SDTM Dataset Specialization Domain (VS)",
                    "type": "SDTM Dataset Specialization Domain"
                }
            },
        },
        ...
       ]
    },
    "name": "SDTM Dataset Specializations Domains",
    "label": "SDTM Dataset Specializations Domains List"
}

Lines 8-20: A list of HATEOS links to SDTM dataset specialization domains, excerpted to show VS.
Each biomedical concept category has 3 elements: href, title, and type.

For an in-depth explanation of HATEOS refer to In-depth: HATEOAS Implementation in CDISC Library API for more information about hypermedia links.

Example 12

NEW

Get a list of the latest version of all SDTM dataset specializations in the VS domain.

/mdr/specializations/sdtm/datasetspecializations?domain=VS

{
    "_links": {
        "datasetSpecializations": [
            {
                "href": "/mdr/specializations/sdtm/datasetspecializations/SYSBP",
                "title": "Systolic Blood Pressure",
                "type": "SDTM Dataset Specialization"
            },
            ...
        ],
        "self": {
            "href": "/mdr/specializations/sdtm/datasetspecializations",
            "title": "SDTM Dataset Specializations (latest version)",
            "type": "SDTM Dataset Specializations List"
        }
    },

Lines 3-10: A list of HATEOS links to SDTM dataset specializations in the VS domain, excerpted to show Systolic Blood Pressure.
Each biomedical concept has 3 elements: href, title, and type.

For an in-depth explanation of HATEOS refer to In-depth: HATEOAS Implementation in CDISC Library API for more information about hypermedia links.



    "name": "SDTM Dataset Specializations (latest version)",
    "label": "SDTM Dataset Specializations List",
    "domain": "VS"
}  
Lines 17-20: Metadata about the SDTM dataset specialization.

Example 13

NEW

Get a list of the latest version of all dataset specializations that specialize the Glucose Measurement biomedical concept.

/mdr/specializations/datasetspecializations?biomedicalconcept=C105585

{
    "_links": {
        "datasetSpecializations": {
            "sdtm": [
                {
                    "href": "/mdr/specializations/sdtm/datasetspecializations/GLUCBLD",
                    "title": "Glucose Concentration in Blood",
                    "type": "SDTM Dataset Specialization"
                },
                {
                    "href": "/mdr/specializations/sdtm/datasetspecializations/GLUCPL",
                    "title": "Glucose Concentration in Plasma",
                    "type": "SDTM Dataset Specialization"
                },
                {
                    "href": "/mdr/specializations/sdtm/datasetspecializations/GLUCSER",
                    "title": "Glucose Concentration in Serum",
                    "type": "SDTM Dataset Specialization"
                },
                {
                    "href": "/mdr/specializations/sdtm/datasetspecializations/GLUCURIN",
                    "title": "Glucose Concentration in Urine",
                    "type": "SDTM Dataset Specialization"
                }
            ]
        },
        "parentBiomedicalConcept": {
            "href": "/mdr/bc/biomedicalconcepts/C105585",
            "title": "Glucose Measurement",
            "type": "Biomedical Concept"
        },
        "self": {
            "href": "/mdr/specializations/datasetspecializations?biomedicalconcept=C105585",
            "title": "Dataset Specializations that specialize a Biomedical Concept",
            "type": "Dataset Specializations List"
        }
    },
    "name": "Dataset Specializations (latest version)",
    "label": "Dataset Specializations List"
}
Lines 4-25: A list of SDTM dataset specializations that specialize the Glucose Measurement biomedical concept (C105585).
  • No labels