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

Get subject information

Retrieve information about a subject.

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 and mode. These values are retrieved as part of a previous task, see Get study information.

Get all subjects

Run the following cURL command to get a list of all subjects:

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-dc-svc/rest/v3.0/studies/{studyId}/{mode}/subjects"

If you want to make subsequent calls for a specific sbuject, take note of the subjectID values associated with the site of your interest.

For more details on this API, like its parameters and response objects, see Get a list of subjects for the specified study and mode.

Get a specific subject

Given a subjectId, run the following cURL command to get information about a specific subject: 

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-dc-svc/rest/v5.0/studies/{studyId}/{mode}/subjects/{subjectId}"

For more details on this API, like its parameters and response objects, see Get a subject based on ID.

Get data elements within a form for a subject

Given a subjectId, formId and siteId, run the following cURL command to get the data elements of a list of items for a subject: 

curl -X GET "https://tenant.clinicalone.oraclecloud.com/ec-dc-svc/rest/v2.0/studies/{studyId}/{mode}/sites/{siteId}/forms/{formId}/subjects/{subjectId}/dataelements"

For more details on this API, like its parameters and response objects, see Get data elements for a subject, a form and a site.

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.