WIKI will be undergoing planned maintenance 12 June 2021 10:00:00 AM CT.
During this 1 hour window the system may be unavailable. Please save any content before this maintenance begins.
Page tree
Skip to end of metadata
Go to start of metadata


In this article, we want to introduce a few ways to make a connection to the CDISC Library via REST API. To help you familiarize with CDISC Library and the REST API technology, we will discuss several methods or tools to obtain a catalog of standards available in the metadata repository.

Basic Concept

To obtain a catalog of standards available, you will, using a client, issue an API query in the form of URL: We can break this REST API query into these components (punctuation combined to related component for brevity):

operationschemehostbase pathendpointpath parameter

operation: Method to be performed. GET is used for retrieving information

scheme: The transfer protocol of the API. Note: https should be used, not http

host: The host (name or IP) serving the API

base path: The base path on which the API is served, which is relative to the host

base URL: The combination of scheme, host, and base path

endpoint: The available paths and operations for the API

path parameter: The variable parts of an API query, use for pointing to a specific resource

Method 1: cURL

cURL is a free and open-source command-line tool that performs file transfer with a URL syntax. It supports a myriad of protocols and platforms. To run the API query above, the minimum requirements are:

curl --header api-key:abcdef0123456789abcdef0123456789 \
     --header Accept:application/json \
     --request GET

Method 2: Windows PowerShell

Similarly, below is a script written for Windows PowerShell that accomplishes the same objective. Notice you must add the API key in the request header (line #2) before sending the API query or you will see a "Unauthorized" message:

$headers = @{}
$url = ""

$result = Invoke-WebRequest -Uri $url -Headers $headers -Method GET

Write-Output $result

Method 3: API Development Tools

Open-source and free API development tools are plentiful in the marketplace. Some of them are:

Method 4: Programming

Refer to Getting Started: Programmatically connect to CDISC Library API

Further Reading

cURL. Tool documentations. Manual page.