Search metagenomics studies

Code snippets

curl "https://api.oanor.com/mgnify-api/v1/studies" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/mgnify-api/v1/studies", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/mgnify-api/v1/studies");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/mgnify-api/v1/studies",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "page": 1,
        "count": 20,
        "query": "marine",
        "total": 953,
        "studies": [
            {
                "id": "MGYS00006861",
                "name": "Marine metagenomic library of Baltic Sea collected in Latvia",
                "biome": "root:Environmental:Aquatic:Marine",
                "abstract": "Marine metagenomic library of Baltic Sea from three distinct locations collected during the period from August to October 2024 in Latvia",
                "bioproject": "PRJEB88144",
                "last_update": "2026-01-16T10:55:30",
                "samples_count": 25
            },
            {
                "id": "MGYS00006848",
                "name": "EMG produced TPA metagenomics assembly of PRJNA553005 data set (Metagenomic views of microbial dynamics influenced by hydrocarbon seepages in sediments of Gulf of Mexico).",
                "biome": "root:Environmental:Aquatic:Marine:Sediment",
                "abstract": "The Third Party Annotation (TPA) assembly was derived from the primary whole genome shotgun (WGS) data set PRJNA553005, and was assembled with metaspades v3.15.3. This project includes samples from the following biomes: root:Environmental:Aquatic:Marine:Sediment.",
                "bioproject": "PRJEB75476",
                "last_update": "2025-08-26T14:50:09",
                "samples_count": 7
            },
            {
                "id": "MGYS00006491",
                "name": "EMG produced TPA metagenomics assembly of PRJEB4352 data set (Shotgun Sequencing of Tara Oceans DNA samples corresponding to size fractions for protist).",
                "biome": "root:Environmental:Aquatic:Marine",
                "abstract": "The Third Party Annotation (TPA) assembly was derived from the primary whole genome shotgun (WGS) data set PRJEB4352, and was assembled with megahit v1.2.9. This project includes samples from the following biomes: root:Environmental:Aquatic:Marine.",
                "bioproject": "PRJEB60351",
                "last_update": "2025-07-04T02:30:33",
                "samples_count": 827
            },
            {
                "id": "MGYS00006813",
                "name": "EMG produced TPA metagenomics assembly of PRJNA375455 data set (Marine microbial communities from the Southern Atlantic ocean transect to study dissolved organic matter and carbon cycling - Knorr_S15_td_AAIW_ad_750m_LV_A metagenome).",
                "biome": "root:Environmental:Aquatic:Marine",
                "abstract": "The Third Party Annotation (TPA) assembly was derived from the primary whole genome shotgun (WGS) data set PRJNA375455, and was assembled with metaspades v3.15.3. This project includes samples from the following biomes: root:Environmental:Aquatic:Marine.",
                "bioproject": "PRJEB68340",
                "last_update": "2025-05-30T12:57:44",
                "samples_count": 1
            },
            {
                "id": "MGYS00006784",
    
…