Understanding the Export cURL Command

The Export cURL Command is a code you can run to export data from your Ripple Registry or from a specific study. You can choose where you’re exporting data from and which variables you want to export, without having to go into Ripple to use the Export Tool. You can export the data into an Excel sheet and further filter and analyze the data.

Understanding the Export cURL Command:

The cURL command contains several pieces of information that you need to provide before you can export the data. This includes:

Here is an example of an Export cURL Command:

  1. The URL of the Ripple Site where you’re exporting data from
  2. Your Authorization Key, which provides your identity and permissions to export the data
  3. The Export Type, which instructs Ripple to export from the Registry or a specific study
    • For a study, you can find your Export Type by going into the study in Ripple, then taking the string of letters and numbers from the URL
  4. The Export Timezone to ensure that any event or date data matches your desired timezone
  5. The names of the variables you wish to export
    • The names of the variables must match how they’re written on the Data Dictionary or on the Export Page
  6. The name of an Excel file that you wish to export the data into


In this example Export cURL Command, we can see that:

  1. We are exporting data from the https://supportplayground.ripplescience.org site
  2. We are providing correct site permissions using the login credentials
  3. We are exporting data from a specific study
  4. We are exporting any date data in the America / Chicago timezone
  5. We are exporting the following variables: global ID, first name, last name, birthday, race, ethnicity, contact for future studies, participant contacts, status, Events (all or none), substudies participation custom variable, potential eligibility custom variable, date screened custom variable, and diagnoses custom variable
  6. The resulting data will be exported into a CSV Excel file named “AncillaryAexport”

You can use this article for instructions on how to build and use your Export cURL Command.

Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.