1. REST API for Oracle Clinical One PlatformREST API for Clinical One Platform
  2. Use cases
  3. Retrieve study information
  4. Get randomization information

Get randomization information

Retrieve information about study randomization.

Note:

  • To run these Oracle Clinical One Platform API calls, you need to include an authentication token. For instructions on how to generate your authentication token, see Get a token for authentication and Use the token to make an API request.
  • For every API call make sure you construct the URL using the correct server URL and path parameters values.
For the following API calls, you need the studyID, version and mode. These values are retrieved as part of a previous task, see Get study information.

Get list of treatment arms

Run the following cURL command to get a list of treatment arms in a study version:

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-designer-svc/rest/v1.0/studies/{studyId}/versions/{version}/arms"

For more details on this API, like its parameters and response objects, see Get list of treatment arms in a study version.

Get randomization design

Run the following cURL command to get the randomization designs in your study version:

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-designer-svc/rest/v5.0/studies/{studyId}/versions/{version}/randomizations"

If you want to make subsequent calls for a specific randomization design, take note of the randomID values associated with the design of your interest.

For more details on this API, like its parameters and response objects, see Get list of randomization designs in a study version.

Get randomization design

Given a randomId, run the following cURL command to get a specific randomization designs in your study version: 

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-designer-svc/rest/v5.0/studies/{studyId}/versions/{version}/randomizations/{randomId}"

If you want to make subsequent calls for a specific randomization design, take note of the randomID values associated with the design of your interest.

For more details on this API, like its parameters and response objects, see Get a randomization design.

Get all kits

Run the following cURL command to get the kits in your study version:

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-designer-svc/rest/v9.0/studies/{studyId}/versions/{version}/kits"

For more details on this API, like its parameters and response objects, see Get a list of all kits.

Get dispensation data of a kit

Run the following cURL command to get the dispensation data of a kit:

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-designer-svc/rest/v6.0/studies/{studyId}/versions/{version}/kits/{kitId}/dispensings"

For more details on this API, like its parameters and response objects, see Get the dispensation data of a kit.

Tip:

There are many different Clinical One APIs that could provide the information you are looking for. Browse for these and other related APIs under the Tasks section of this guide. If you see any deprecated endpoint, look for its newest version.