{"openapi":"3.1.0","info":{"title":"Genome Assemblies API","version":"1.0.0","description":"Reference genome assemblies as an API — powered by NCBI Assembly, the registry of genome builds for organisms across the tree of life. Search assemblies by organism (or free text) and look up any assembly's metadata: its accession (GCF_… RefSeq or GCA_… GenBank), name (e.g. GRCh38.p14), organism and taxon id, assembly level (complete genome, chromosome, scaffold or contig), contiguity statistics (contig and scaffold N50), sequencing coverage, RefSeq category, UCSC and Ensembl names, the submitting organization, release date and FTP download paths. From the human reference genome to any sequenced microbe, plant or animal, it turns the genome-assembly registry into a clean search-and-fetch API. A genome-assembly registry — distinct from sequence (ENA), genome annotation (Ensembl), variant (ClinVar, dbVar) and gene-expression (GEO) databases. Open data from NCBI Assembly (public domain).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/genomes-api","description":"oanor gateway"}],"tags":[{"name":"Genome Assemblies"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/assembly":{"get":{"operationId":"get_v1_assembly","tags":["Genome Assemblies"],"summary":"A genome assembly's metadata","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Accession, name or uid (from /v1/search)","schema":{"type":"string"},"example":"GCF_000001405.40"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"assembly":{"uid":"11968211","url":"https://www.ncbi.nlm.nih.gov/datasets/genome/GCF_000001405.40/","date":"2022-02-08","name":"GRCh38.p14","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCF_000001405.40","submitter":"Genome Reference Consortium","ucsc_name":"hg38","contig_n50":57879411,"ftp_refseq":"ftp://ftp.ncbi.nlm.nih.gov/genomes/all/GCF/000/001/405/GCF_000001405.40_GRCh38.p14","description":"Genome Reference Consortium Human Build 38 patch release 14 (GRCh38.p14)","ftp_genbank":"ftp://ftp.ncbi.nlm.nih.gov/genomes/all/GCA/000/001/405/GCA_000001405.29_GRCh38.p14","scaffold_n50":67794873,"assembly_type":"haploid-with-alt-loci","release_level":"Patch","refseq_category":"reference genome","genbank_accession":"GCF_000001405.26"}},"meta":{"timestamp":"2026-06-01T23:40:54.136Z","request_id":"7a21b94d-2f96-4203-84bc-17fb9d7df733"},"status":"ok","message":"Assembly retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Genome Assemblies"],"summary":"Search genome assemblies","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Organism or free-text query","schema":{"type":"string"},"example":"Homo sapiens"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"Homo sapiens","total":3243,"assemblies":[{"name":"HG03453_haplotype2_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057084165.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG02293_haplotype1_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057079665.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG03453_haplotype1_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_056750235.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG02145_haplotype1_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_056750195.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG02523_haplotype1_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_056750345.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG02523_haplotype2_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_056750355.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG02717_mat_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057062045.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG02293_haplotype2_hprc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057062025.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00096_haplotype1_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057057025.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00096_haplotype2_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056985.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00358_haplotype2_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056945.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00358_haplotype1_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056955.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00512_haplotype2_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056895.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00512_haplotype1_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056925.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00731_haplotype1_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056885.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG00731_haplotype2_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056865.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG01457_haplotype2_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056835.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG01505_mat_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056805.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG01457_haplotype1_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056825.1","submitter":"NHGRI/NIH","refseq_category":"na"},{"name":"HG01596_haplotype1_hprc-hgsvc_rel2_verkko2_supp","level":"Chromosome","organism":"Homo sapiens (human)","taxon_id":"9606","accession":"GCA_057056765.1","submitter":"NHGRI/NIH","refseq_category":"na"}]},"meta":{"timestamp":"2026-06-01T23:40:55.815Z","request_id":"dbc8239c-6c39-4666-99ab-11eaac99d780"},"status":"ok","message":"Assemblies retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Assembly levels & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"NCBI Assembly is the registry of genome assemblies — the reference genome builds for organisms across the tree of life. /v1/search?q=Homo sapiens finds genome assemblies for an organism (or by free text), returning each assembly's accession (GCF_… RefSeq / GCA_… GenBank), name, organism, taxon id, assembly level (Complete Genome, Chromosome, Scaffold, Contig), RefSeq category, UCSC/Ensembl names, submitter and release date; /v1/assembly?id=GCF_000001405.40 returns a single assembly's metadata — accession, name, organism, level, contig and scaffold N50, sequencing coverage, type, linked BioSample, description and FTP download paths (you may pass the accession, the assembly name like GRCh38.p14, or a numeric uid). Data from NCBI Assembly (public domain). A genome-assembly registry — distinct from sequence (ENA), genome annotation (Ensembl), variant (ClinVar/dbVar) and expression (GEO) databases. Ideal for bioinformatics, comparative genomics and reference-genome tooling.","levels":["Complete Genome","Chromosome","Scaffold","Contig"],"source":"NCBI Assembly — genome assembly registry (ncbi.nlm.nih.gov/assembly)","endpoints":["/v1/search","/v1/assembly","/v1/meta"]},"meta":{"timestamp":"2026-06-01T23:40:55.917Z","request_id":"39a1ecb1-1ab6-4a4d-9ddf-18d7ff8de5a6"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2210,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":615,"monthly_call_quota":44000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2040,"monthly_call_quota":220000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5600,"monthly_call_quota":815000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/genomes-api"}