OpenClinica has a highly capable RESTful web services API that enables you to interchange data programmatically with other systems, as well as carry out bulk actions such as importing data, scheduling events, or creating study participants.

The following pages are designed to help you understand how to use this API. We also provide an API toolset, called Swagger, that enables you to better understand and interact with various API endpoints.

To Access the Swagger Interface for your OpenClinica Domain:

  1. Click the User menu.
  2. Select Administration.
  3. Select Web Services Information.

API users of OpenClinica will need an authentication token in order to access the API endpoints.

To Obtain an Authentication Token Call the Following Endpoint:

URL:

POST {serverName}/user-service/api/oauth/tokenwhere {serverName} is your study build URL.

For example: https://xyz.build.openclinica.io

Request Header:

  • Content-Type: application/json

Request Body:

{
	"username":" ",
	"password":" "
}

Response Body:

Response body will contain the authentication token.

Supply this Authentication Token (as shown below) in the Authorization Header as a Bearer Token When Accessing Other Endpoints:

Authorization: Bearer “authentication token“;