Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

National Institutes of Health (NIH) Taxonomy API

#### Options to download taxonomy data.These taxonomy services allow you to get taxonomy data as a data report or download taxonomy data as a taxonomy data package, for taxonomic nodes in NCBI Taxonomy.

National Institutes of Health (NIH) Taxonomy 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 Taxonomy. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 20 operations across 20 paths, and defines 60 schemas. It is described by OpenAPI 3.0.3, at version 2.0.5.

Requests are made against a single base URL, https://clinicaltrials.gov/api/v2.

20 operations 20 paths 60 schemas 10 GET10 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0.5
Base URL
https://eutils.ncbi.nlm.nih.gov/entrez/eutils/
Resource Areas
1

Paths & Operations 20

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

Taxonomy 20

Options to download taxonomy data. These taxonomy services allow you to get taxonomy data as a data report or download taxonomy data as a taxonomy data package, for taxonomic node…

GET
/taxonomy/taxon/{tax_ids}/download
Get a taxonomy data package by Taxonomy ID
download_taxonomy_package 3 params → default200
POST
/taxonomy/download
Get a taxonomy data package by Taxonomy ID
download_taxonomy_package_by_post 1 param body → default200
GET
/taxonomy/taxon/{taxons}deprecated
Use taxonomic identifiers to get taxonomic metadata
taxonomy_metadata 8 params → default200
POST
/taxonomydeprecated
Get taxonomy metadata by taxon
taxonomy_metadata_post body → default200
GET
/taxonomy/taxon/{taxons}/dataset_report
Get a taxonomy data report by taxon
taxonomy_data_report 8 params → default200
POST
/taxonomy/dataset_report
Get a taxonomy data report by taxon
taxonomy_data_report_post body → default200
GET
/taxonomy/taxon/{taxons}/name_report
Get a taxonomy names report by taxon
taxonomy_names 5 params → default200
POST
/taxonomy/name_report
Get a taxonomy names report by taxon
taxonomy_names_post body → default200
GET
/taxonomy/taxon/{tax_id}/related_ids
Get child nodes, and optionally parent nodes, for a given taxon by Taxonomy ID
taxonomy_related_ids 5 params → default200
POST
/taxonomy/related_ids
Get child nodes, and optionally parent nodes, for a given taxon by Taxonomy ID
taxonomy_related_ids_post body → default200
GET
/taxonomy/taxon/{taxons}/filtered_subtree
Get a filtered taxonomic subtree by taxon
taxonomy_filtered_subtree 6 params → default200
POST
/taxonomy/filtered_subtree
Get a filtered taxonomic subtree by taxon
taxonomy_filtered_subtree_post body → default200
GET
/taxonomy/taxon_suggest/{taxon_query}
Get a list of taxonomy names and IDs by partial taxonomic name
tax_name_query 4 params → default200
POST
/taxonomy/taxon_suggest
Get a list of taxonomy names and IDs by partial taxonomic name
tax_name_query_by_post body → default200
GET
/taxonomy/taxon/{taxon}/links
Get external links by Taxonomy ID
taxonomy_links 1 param → default200
POST
/taxonomy/links
Get external links by Taxonomy ID
taxonomy_links_by_post body → default200
GET
/taxonomy/taxon/{taxon}/image
Get a taxonomy image by taxon
taxonomy_image 2 params → default200
POST
/taxonomy/image
Get a taxonomy image by taxon
taxonomy_image_post body → default200
GET
/taxonomy/taxon/{taxon}/image/metadata
Get taxonomy image metadata by Taxonomy ID
taxonomy_image_metadata 1 param → default200
POST
/taxonomy/image/metadata
Get taxonomy image metadata by Taxonomy ID
taxonomy_image_metadata_post body → default200

Schemas 60

The contract defines 60 schemas that model the data the API accepts and returns. The most detailed are v2TaxonomyNode (17 properties), v2reportsTaxonomyNode (15 properties), v2reportsNameAndAuthority (12 properties), v2reportsClassification (11 properties). Each schema is shown below with its type and property counts.

v2reportsErrorOrganelleErrorCode
string
v2TaxonomyMetadataRequest
object
8 properties
v2TaxonomyDatasetRequest
object
2 properties
v2TaxonomyFilteredSubtreeResponseEdge
object
6 properties
v2reportsTaxonomyNode
object
15 properties
v2reportsErrorAssemblyErrorCode
string
v2reportsRankType
string
v2reportsNameAndAuthorityPublication
object
3 properties
v2reportsNameAndAuthority
object
12 properties
v2reportsCollectionType
string
v2TaxonomyTaxIdsPage
object
2 properties
v2reportsTaxonomyReportMatch
object
4 properties
v2reportsError
object
8 properties
v2HttpBody
object
2 properties
v2TaxonomyImageRequest
object
2 properties
v2OrganismQueryRequest
object
5 properties
v2TaxonomyFilteredSubtreeResponseEdgesEntry
object
A map.
1 property
v2OrganismQueryRequestTaxRankFilter
string
v2reportsTaxonomyNodeCountByType
object
2 properties
v2TaxonomyImageMetadataRequest
object
1 property
v2reportsTaxData
object
2 properties
v2TaxonomyMetadataRequestContentType
string
v2reportsWarningReplacedId
object
2 properties
v2reportsErrorVirusErrorCode
string
v2TaxonomyLinksResponseGenericLink
object
2 properties
v2reportsCountType
string
v2TaxonomyMetadataRequestTableFormat
string
v2reportsTaxonomyNamesReportMatch
object
4 properties
v2ImageSize
string
v2TaxonomyFilteredSubtreeRequest
object
6 properties
v2reportsTaxonomyNamesDescriptor
object
10 properties
v2reportsTaxonomyNamesDescriptorCitation
object
3 properties
v2TaxonomyNodeCountByType
object
2 properties
v2reportsClassification
object
11 properties
v2TaxonomyLinksRequest
object
1 property
v2TaxonomyFilteredSubtreeResponseEdgeChildStatus
string
v2TaxonomyImageMetadataResponse
object
8 properties
v2IncludeTabularHeader
string
v2TaxonomyMatch
object
4 properties
v2TaxonomyDatasetRequestTaxonomyReportType
string
v2reportsTaxonomyDataReportPage
object
4 properties
v2reportsErrorTaxonomyErrorCode
string
v2reportsTaxonomyTypeMaterial
object
6 properties
v2reportsNameAndAuthorityNoteClassifier
string
v2reportsNameAndAuthorityNote
object
3 properties
protobufAny
object
2 properties
v2SciNameAndIds
object
1 property
v2reportsMessage
object
2 properties
v2reportsErrorGeneErrorCode
string
v2OrganismQueryRequestTaxonResourceFilter
string
v2TaxonomyMetadataResponse
object
2 properties
v2reportsTaxonomyNamesDataReportPage
object
4 properties
v2TaxonomyLinksResponse
object
7 properties
rpcStatus
object
3 properties
v2TaxonomyRelatedIdRequest
object
6 properties
v2reportsWarningGeneWarningCode
string
v2SciNameAndIdsSciNameAndId
object
6 properties
v2reportsWarning
object
5 properties
v2TaxonomyFilteredSubtreeResponse
object
4 properties
v2TaxonomyNode
object
17 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nih-taxonomy-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) Genome 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