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

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

`POST /taxonomy/taxon_suggest`

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

## Request body

- V2OrganismQueryRequest
  - `organism_query` string
  - `taxon_query` string
  - `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.

---

[API](https://skmtc.net/ncats/apis/ncbi-datasets-api.md) · [All operations](https://skmtc.net/ncats/apis/ncbi-datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ncats/ncbi-datasets-api/revisions/c6fcf8559d4a/schema)