The Open Humans public data API allows you to retrieve JSON representations of data shared publicly by Open Humans members, including URLs to download that data.
if you plan to use public data, please read our guidelines for using public data.
The base URL for the API is
Because the API only returns public data no authentication is required.
The API uses pagination via the
parameter; the default page size is 100 results. A smaller or larger page
size can be specified with the
You may filter the results with these querystring parameters:
created_startthe start date to filter from (inclusive)
created_endthe end date to filter to (inclusive)
sourcethe name of a data souce, like
direct-sharing-139, or a comma-separated list of sources, like
usernamea username, like
member_idan Open Humans member ID, like
This query searches for the 5 most recently updated data files from user
This query shows all Harvard Personal Genomes Project data updated on 2/14/2016:
There are also two ways to see which users have which data sources:
Create a search URL for a specific data type:
You can query the projects endpoint to get information about projects:
You can filter this list by a project's `id_label` or `id`:
We've introduced DataTypes as a method for managing data sharing permissions. Projects that add data to Open Humans accounts should register DataTypes for the data they may upload. You can see a list of all DataTypes here:
You can also filter on a specific project label to see what DataTypes it has registered.