---
title: "Get a list of taxonomy names and IDs by partial taxonomic name"
method: GET
path: "/taxonomy/taxon_suggest/{taxon_query}"
tags: ["Taxonomy"]
---

# Get a list of taxonomy names and IDs by partial taxonomic name

`GET /taxonomy/taxon_suggest/{taxon_query}`

## Request

- Base URL: `https://api.ncbi.nlm.nih.gov/datasets/v2`
- URL: `https://api.ncbi.nlm.nih.gov/datasets/v2/taxonomy/taxon_suggest/{taxon_query}`
- Auth: API key in header `api-key`

Get a list of taxonomy names and IDs in JSON format.

## Path parameters

- `taxon_query` string, required

## Query parameters

- `tax_rank_filter` 'species' | 'higher_taxon'
- `taxon_resource_filter` 'TAXON_RESOURCE_FILTER_ALL' | 'TAXON_RESOURCE_FILTER_GENOME' | 'TAXON_RESOURCE_FILTER_GENE' | 'TAXON_RESOURCE_FILTER_ORGANELLE'
- `exact_match` boolean

## Response `200`

A successful response

- V2SciNameAndIds
  - `sci_name_and_ids` V2SciNameAndIdsSciNameAndId[]
    - `sci_name` string
    - `tax_id` string, uint64
    - `common_name` string
    - `matched_term` string
    - `rank` 'NO_RANK' | 'SUPERKINGDOM' | 'DOMAIN' | 'REALM' | 'KINGDOM' | 'SUBKINGDOM' | 'SUPERPHYLUM' | 'SUBPHYLUM' | 'PHYLUM' | 'CLADE' | 'SUPERCLASS' | 'CLASS' | 'SUBCLASS' | 'INFRACLASS' | 'COHORT' | 'SUBCOHORT' | 'SUPERORDER' | 'ORDER' | 'SUBORDER' | 'INFRAORDER' | 'PARVORDER' | 'SUPERFAMILY' | 'FAMILY' | 'SUBFAMILY' | 'GENUS' | 'SUBGENUS' | 'SPECIES_GROUP' | 'SPECIES_SUBGROUP' | 'SPECIES' | 'SUBSPECIES' | 'TRIBE' | 'SUBTRIBE' | 'FORMA' | 'VARIETAS' | 'STRAIN' | 'SECTION' | 'SUBSECTION' | 'PATHOGROUP' | 'SUBVARIETY' | 'GENOTYPE' | 'SEROTYPE' | 'ISOLATE' | 'MORPH' | 'SERIES' | 'FORMA_SPECIALIS' | 'SEROGROUP' | 'BIOTYPE' | 'ACELLULAR_ROOT' | 'CELLULAR_ROOT'
    - `group_name` string

## Other responses

- `default`: An unexpected error response.

## Changes

- **2025-05-08** `6b24249801ec`: 2 breaking, 1 info
  - for the `query` request parameter `tax_rank_filter`, default value `species` was added
  - for the `query` request parameter `taxon_resource_filter`, default value `TAXON_RESOURCE_FILTER_ALL` was added
  - the `rank` response's property default value `NO_RANK` was added for the status `200`
- **2025-04-28** `f08be9b66e16`: 2 breaking, 4 warning, 1 info
  - for the `query` request parameter `tax_rank_filter`, default value `species` was removed
  - for the `query` request parameter `taxon_resource_filter`, default value `TAXON_RESOURCE_FILTER_ALL` was removed
  - added the new `ACELLULAR_ROOT` enum value to the `sci_name_and_ids/items/rank` response property for the response status `200`
  - added the new `CELLULAR_ROOT` enum value to the `sci_name_and_ids/items/rank` response property for the response status `200`
  - …3 more
- **2025-02-08** `00bdccfc6283`: 1 breaking, 5 info
  - removed the media type `application/json` for the response with the status `default`
  - added the new optional `query` request parameter `exact_match`
  - added the new enum value `TAXON_RESOURCE_FILTER_ORGANELLE` to the `query` request parameter `taxon_resource_filter`
  - added the media type `text/plain` for the response with the status `default`
  - …2 more
- **2023-11-14** `b4da81b65e0a`: 1 info
  - added the new optional `query` request parameter `taxon_resource_filter`

[Operation history](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/taxonomy/taxon_suggest/:taxon_query/get.md)

---

[API](https://skmtc.dev/ncats/apis/ncbi-datasets-api.md) - [All operations](https://skmtc.dev/ncats/apis/ncbi-datasets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ncats/apis/ncbi-datasets-api/revisions/b24db4bc7ca5?raw)