How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

National Institutes of Health (NIH) Genome API

#### Options to download assembled genome data, including the associated sequence, annotation and metadata.These genome services allow you to get genome metadata as a data report or download genome, transcript and protein sequence, annotation and metadata as a genome data package, for assembled genomes.

National Institutes of Health (NIH) Genome API is one of 15 APIs that National Institutes of Health (NIH) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Genome. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 31 operations across 31 paths, and defines 105 schemas. It is described by OpenAPI 3.2.0, at version v2.

Requests are made against a single base URL, https://api.ncbi.nlm.nih.gov/datasets/v2.

31 operations 31 paths 105 schemas 18 GET13 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v2
Base URL
https://eutils.ncbi.nlm.nih.gov/entrez/eutils/
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

National Institutes of Health (NIH) Genome API declares 2 security schemes for authenticating requests. An API key is passed in the query as api_key (ApiKeyAuth). An API key is passed in the header as api-key (ApiKeyAuthHeader). By default, every request must be authenticated.

Paths & Operations 31

Across 31 paths, the API surfaces 31 operations — 18 GET, 13 POST. Each is listed below with its method, path, parameters, and response codes.

Genome 31

Options to download assembled genome data, including the associated sequence, annotation and metadata. These genome services allow you to get genome metadata as a data report or d…

GET
/genome/accession/{accessions}/download_summary
Get a download summary (preview) of a genome data package by genome assembly accession
genome_download_summary 3 params → default200
POST
/genome/download_summary
Get a download summary (preview) of a genome data package by genome assembly accession
genome_download_summary_by_post body → default200
GET
/genome/accession/{accessions}/dataset_report
Get a genome assembly report by genome assembly accession
genome_dataset_report 23 params → default200
GET
/genome/taxon/{taxons}/dataset_report
Get a genome assembly report by taxon
genome_dataset_reports_by_taxon 24 params → default200
GET
/genome/bioproject/{bioprojects}/dataset_report
Get genome assembly reports by BioProject accession
genome_dataset_reports_by_bioproject 24 params → default200
GET
/genome/biosample/{biosample_ids}/dataset_report
Get genome assembly reports by BioSample accession
genome_dataset_reports_by_biosample_id 24 params → default200
GET
/genome/wgs/{wgs_accessions}/dataset_report
Get a genome assembly data report by WGS accession
genome_dataset_reports_by_wgs 24 params → default200
GET
/genome/assembly_name/{assembly_names}/dataset_report
Get genome assembly reports by assembly name
genome_dataset_reports_by_assembly_name 24 params → default200
POST
/genome/dataset_report
Get a genome assembly report
genome_dataset_report_by_post body → default200
GET
/genome/sequence_accession/{accession}/sequence_assemblies
Get a genome assembly accession for a nucleotide sequence accession
assembly_accessions_for_sequence_accession 1 param → default200
POST
/genome/sequence_assemblies
Get a genome assembly accession for a nucleotide sequence accession
assembly_accessions_for_sequence_accession_by_post body → default200
GET
/genome/accession/{accession}/sequence_reports
Get a genome sequence report by genome assembly accession
genome_sequence_report 8 params → default200
POST
/genome/sequence_reports
Get a genome sequence report by genome assembly accession
genome_sequence_report_by_post body → default200
GET
/genome/accession/{accessions}/links
Get assembly links by genome assembly accession
genome_links_by_accession 2 params → default200
POST
/genome/links
Get assembly links by genome assembly accession
genome_links_by_accession_by_post body → default200
GET
/genome/taxon/{species_taxon}/checkm_histogram
Get CheckM histogram data by species taxon
checkm_histogram_by_taxon 1 param → default200
POST
/genome/checkm_histogram
Get CheckM histogram data by species taxon
checkm_histogram_by_taxon_by_post body → default200
GET
/genome/accession/{accessions}/download
Get a genome data package by genome assembly accession
download_assembly_package 5 params → default200
POST
/genome/download
Get a genome data package by genome assembly accession
download_assembly_package_post 1 param body → default200
GET
/genome/accession/{accession}/annotation_report/download
Get a genome annotation data package by genome assembly accession
download_genome_annotation_package 10 params → default200
POST
/genome/annotation_report/download
Get a genome annotation data package by genome assembly accession
download_genome_annotation_package_by_post 1 param body → default200
GET
/genome/accession/{accessions}/check
Check the validity of a genome assembly accession
check_assembly_availability 1 param → default200
POST
/genome/check
Check the validity of a genome assembly accession
check_assembly_availability_post body → default200
GET
/genome/accession/{accession}/annotation_report
Get genome annotation reports by genome assembly accession
genome_annotation_report 12 params → default200
POST
/genome/annotation_report
Get genome annotation reports by genome assembly accession
genome_annotation_report_by_post body → default200
GET
/genome/accession/{accession}/annotation_summary
Get genome annotation report summary information by genome assembly accession
annotation_report_facets_by_accession 3 params → default200
POST
/genome/annotation_summary
Get genome annotation report summary information by genome assembly accession
annotation_report_facets_by_post body → default200
GET
/genome/accession/{accession}/annotation_report/download_summary
Get a download summary (preview) of a genome annotation data package by genome assembly accession
genome_annotation_download_summary 9 params → default200
POST
/genome/annotation_report/download_summary
Get a download summary (preview) of a genome annotation data package by genome assembly accession
genome_annotation_download_summary_by_post body → default200
GET
/genome/accession/{accession}/revision_history
Get a revision history for a genome assembly by genome assembly accession
assembly_revision_history_by_get 1 param → default200
POST
/genome/revision_history
Get a revision history for a genome assembly by genome assembly accession
assembly_revision_history_by_post body → default200

Schemas 105

The contract defines 105 schemas that model the data the API accepts and returns. The most detailed are v2reportsBioSampleDescriptor (38 properties), v2reportsAssemblyInfo (26 properties), v2reportsGenomeAnnotation (22 properties), v2reportsAssemblyStats (16 properties). Each schema is shown below with its type and property counts.

v2reportsContentType
string
v2reportsBioSampleOwner
object
2 properties
rpcStatus
object
3 properties
v2reportsRnaType
string
v2reportsANITypeCategory
string
protobufAny
object
2 properties
v2AssemblyCheckMHistogramRequest
object
1 property
v2reportsAnnotationInfo
object
11 properties
v2reportsAssemblyDataReportPage
object
5 properties
v2reportsWGSInfo
object
3 properties
v2reportsFeatureCounts
object
1 property
v2AssemblyCheckMHistogramReplyHistogramInterval
object
3 properties
v2GenomeAnnotationRequestGenomeAnnotationTableFormat
string
v2IncludeTabularHeader
string
v2reportsBioSampleId
object
3 properties
v2reportsRange
object
5 properties
v2reportsGenomicLocation
object
4 properties
v2reportsErrorOrganelleErrorCode
string
v2reportsOrganelleInfo
object
6 properties
v2AssemblyCheckMHistogramReply
object
2 properties
v2reportsBioSampleAttribute
object
2 properties
v2reportsTranscript
object
9 properties
v2reportsLinkedAssemblyType
string
v2reportsGeneType
string
v2reportsErrorVirusErrorCode
string
v2DownloadSummaryFileSummary
object
2 properties
v2reportsTranscriptSelectCategory
string
v2reportsGenomeAnnotationReportPage
object
4 properties
v2AssemblyDatasetDescriptorsFilter
object
15 properties
v2AnnotationForAssemblyType
string
v2DownloadSummaryAvailableFiles
object
9 properties
v2reportsError
object
8 properties
v2reportsGenomicRegion
object
2 properties
v2SortField
object
2 properties
v2reportsBioProjectLineage
object
1 property
v2SequenceAccessionRequest
object
1 property
v2reportsBioSampleStatus
object
2 properties
v2reportsTypeMaterial
object
2 properties
v2reportsGenomeAnnotation
object
22 properties
v2reportsOrientation
string
v2GenomeAnnotationTableSummaryReply
object
4 properties
v2reportsAssemblyStatus
string
v2reportsWarningReplacedId
object
2 properties
v2reportsErrorTaxonomyErrorCode
string
v2AssemblyDatasetDescriptorsFilterMetagenomeDerivedFilter
string
v2reportsTranscriptTranscriptType
string
v2reportsLinkedAssembly
object
2 properties
v2reportsSourceDatabase
string
v2reportsSeqRangeSet
object
2 properties
v2DownloadSummaryDehydrated
object
4 properties
v2AssemblyRevisionHistory
object
2 properties
v2reportsAverageNucleotideIdentityTaxonomyCheckStatus
string
v2reportsOrganism
object
8 properties
v2reportsPairedAssembly
object
9 properties
v2reportsGenomeAnnotationReportMatch
object
5 properties
v2reportsAssemblyLevel
string
v2reportsGenomicRegionGenomicRegionType
string
v2AssemblyLinksReplyAssemblyLinkType
string
v2reportsCheckM
object
7 properties
v2reportsBioSampleContact
object
1 property
v2reportsGeneCounts
object
5 properties
v2reportsErrorGeneErrorCode
string
v2reportsLineageOrganism
object
2 properties
v2AssemblyDatasetReportsRequestContentType
string
v2AssemblyDatasetDescriptorsFilterAssemblySource
string
v2AssemblyRevisionHistoryRequest
object
1 property
v2AssemblyLinksRequest
object
2 properties
v2GenomeAnnotationRequest
object
13 properties
v2reportsAssemblyDataReport
object
14 properties
v2GenomeAnnotationRequestAnnotationType
string
v2reportsAtypicalInfo
object
2 properties
v2reportsMaturePeptide
object
3 properties
v2reportsAssemblyInfo
object
26 properties
v2AssemblyDatasetDescriptorsFilterAssemblyVersion
string
v2SortDirection
string
v2reportsSequenceInfo
object
15 properties
v2reportsBuscoStat
object
8 properties
v2DownloadSummary
object
8 properties
v2reportsProtein
object
6 properties
v2reportsWarningGeneWarningCode
string
v2reportsWarning
object
5 properties
v2reportsAverageNucleotideIdentityMatchStatus
string
v2reportsAssemblyStats
object
16 properties
v2AssemblySequenceReportsRequest
object
9 properties
v2reportsBioSampleDescriptor
object
38 properties
v2reportsMessage
object
2 properties
v2AssemblyDatasetRequestResolution
string
v2reportsBioSampleDescription
object
3 properties
v2AssemblyDatasetAvailability
object
3 properties
v2DownloadSummaryHydrated
object
3 properties
v2AssemblyLinksReply
object
1 property
v2reportsErrorAssemblyErrorCode
string
v2AssemblyDatasetDescriptorsFilterTypeMaterialCategory
string
v2reportsBioProject
object
4 properties
v2reportsAverageNucleotideIdentity
object
8 properties
v2reportsAdditionalSubmitter
object
6 properties
v2AssemblyAccessions
object
1 property
v2reportsInfraspecificNames
object
6 properties
v2reportsAnnotation
object
5 properties
v2AssemblyDatasetReportsRequest
object
16 properties
v2reportsANIMatch
object
6 properties
v2SequenceReportPage
object
3 properties
v2AssemblyDatasetRequest
object
5 properties
v2reportsAssemblyRevision
object
8 properties
v2AssemblyLinksReplyAssemblyLink
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nih-genome-api-openapi.yml Raw ↑

Other APIs National Institutes of Health (NIH) publishes across the network.

NCBI E-utilities (Entrez Programming Utilities)
PubChem Power User Gateway (PUG REST)
NIH RePORTER API
NCBI BLAST URL API
PubMed Central (PMC) OA API
National Institutes of Health (NIH) BioSample API
National Institutes of Health (NIH) Gene API
National Institutes of Health (NIH) Organelle API
National Institutes of Health (NIH) Prokaryote API
National Institutes of Health (NIH) Stats API
National Institutes of Health (NIH) Studies API
National Institutes of Health (NIH) Taxonomy API
Where this information came from

This is an independent, third-party profile of National Institutes of Health (NIH) Genome API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.