On-site features

When is an "on-site" project appropriate?

"On-site authorization" may be appropriate if...

  • You just want something simple.
  • You have limited technical resources.
  • You are NOT running an accounts-based website or phone app.


Here's a summary of main features:

  • Works immediately.
    You can immediately use all these features, but your project is limited to a maximum of 20 users. You'll need to apply for project approval to remove this cap. Once approved, Open Humans will invite members to join your project.

  • Access to private data.
    Select which data sources you want to request access to. If a member authorizes sharing with your project, you'll immediately have access to any of their data from those sources via our API.

    If you wish to only access public data for a member, you should instead request username access (see below).

  • Username information is optional.
    Each member's data comes via a random project-specific member ID. You will not receive username access unless you request it.

    Not receiving username access can improve security and facilitate IRB review – if data is anonymous, the review might be expedited.

    On the other hand, if you only want to work with public data, you can request username access (and no data sources). You'll be able to retrieve the member's public data using the Public Data API.

  • Send messages to project members.
    You can request authorization to send messages to your project members. This messaging does not reveal their email or username to you.

    Messages can target specific project member IDs and can contain the project member ID within the message. That means you can use embed the ID in a custom URL for a survey, to collect additiional information from a member.

  • Consent occurs within Open Humans.
    You give us the text you want displayed. This text can be formatted using Markdown syntax.

  • Forward member to a project URL.
    You may optionally specify a URL for a member to be forwarded to after they enroll and authorize your project. This URL can have their project member ID embedded within it (e.g. as a parameter for a form).

  • Upload data to member accounts.
    Projects can be data sources: you can upload data for a member to their account. This data will be private, accessible only by your project and the member. The member can download the data and manage its sharing within Open Humans.

  • Access and upload data through command-line tools
    Use the tools provided by open-humans-api to download the data of your project's members in bulk and bulk-upload new data.