Skip to main content
POST
Resolves a scientific name, common name, recorded misspelling or NCBI Taxonomy ID to matching organisms in the Taxonomy database of the US National Center for Biotechnology Information: taxonomy ID, scientific name, common name, rank, division, lineage from the root down and whether the ID sent is current. NCBI’s Disclaimer (https://www.ncbi.nlm.nih.gov/home/about/policies/#disclaimer) and Copyright notice (https://www.ncbi.nlm.nih.gov/home/about/policies/#copyright) apply to these records:
  • the US Government does not warrant or assume any legal liability or responsibility for their accuracy, completeness or usefulness, and
  • NCBI does not endorse or recommend any commercial products, processes or services.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
A scientific name (Homo sapiens), common name (human) or misspelling the source records; give exactly one of name or taxonomy_id. 2 to 200 characters. No double quotes, brackets or control characters.
integer
An NCBI Taxonomy ID, for example 9606; give exactly one of name or taxonomy_id. From 1 to 999999999.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always organism_resolve
object
The answer, described under Result below
object
Where the answer came from and when
string
The public body the data comes from. Always US National Center for Biotechnology Information.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
The date the source last changed the record, when the answer names one organism; null otherwise.

Result

Nested under data.result.
object[]
Matching organisms in the source’s order, up to 10.
integer
The NCBI Taxonomy ID of the record, the one the source uses now.
string
The scientific name, for example Homo sapiens.
string | null
The common name, for example human; null when the source records none.
string | null
The rank as the source writes it: species, genus, family, no rank and so on. null when the source gives no value.
string | null
The source’s division, for example Primates or Bacteria. null when the source gives no value.
object[]
The ancestors in order, from the root of the tree down to the parent of this record.
string | null
The rank of this ancestor as the source writes it. null when the source gives no value.
string
The ancestor’s scientific name.
integer
The ancestor’s NCBI Taxonomy ID.
boolean
False when the taxonomy_id sent is a retired id the source merged into this record.
boolean
True when the name matched more than one organism.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • Give exactly one of name or taxonomy_id.
  • name matches every name the source keeps for an organism, including common names and the misspellings it records, so Home sapiens resolves to Homo sapiens. The whole name must match; it is not a word search.
  • A name shared by more than one organism (mouse is both the species Mus musculus and the genus Mus) returns each, up to 10, in the source’s order, with ambiguous true.
  • A retired taxonomy ID returns the record it was merged into, with active false.
  • An unknown name or taxonomy ID returns an empty matches list.
  • The NCBI Taxonomy ID is the taxon_id input of Gene Resolve.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}