Signals Synergy: Getting CRO users via API

Descripiton

This article explains how to retrieve a list of CRO users via Signals Notebook APIs. The expected audience is developers working to integrate an external system with Signals Synergy.

Scenario 1: Retrieving all the CRO users from a specific CRO

If you need to retrieve all the CRO users from a specific CRO, please follow the steps below.

1. Identify the CRO ID: If you already have the CRO ID for the CRO, you can skip this step.
   1. Open "Synergy Configurations" from either Signals Portal or the App Launcher menu.
   2. Go to the "Contract Research Organizations" smart folder. You will see a list of CROs.
   3. Click on the CRO you want to know the ID of.
   4. Your browser shows the CRO details. Check the URL bar of the browser, which should look like below.
      <tenant URL>/synergyconfig/cros/cro:4/departments
   5. The text between "/cors/" and the next "/" is the CRO ID. In the example above, the CRO ID is cro:4.
2. Calling the API from the Swagger page:
   1. Open the Swagger page in Signals Configuration.
   2. Find the "Synergy" section. Click on it to expand it.
   3. Find the endpoint GET /synergy/cros/{croId}/users.
      
   4. Expand this endpoint and click on "Try it out".
   5. In the enabled field, select "true" if you want to filter out deactivated users.
   6. In the croId field, type in the CRO ID.
      
   7. Click on "Execute".
       

Scenario 2: Retrieving all the CRO from all the CROs in the Signals tenant

If you need to retrieve all the CRO users across CROs in your Signals Tenant, the following knowledge base article explains how to do it step-by-step. 

Signals Notebook: How to call CRO users registered in a tenant using API in Swagger