---
title: "Get a taxonomy image by taxon"
method: GET
path: "/taxonomy/taxon/{taxon}/image"
tags: ["Taxonomy"]
---

# Get a taxonomy image by taxon

`GET /taxonomy/taxon/{taxon}/image`

## Request

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

Get an image associated with the specified taxon. By default, in JPEG format, but also available in PNG (accept: image/png), TIFF (accept: accept: image/tiff), and SVG+XML (accept: image/svg+xml) formats.

## Path parameters

- `taxon` string, required

## Query parameters

- `image_size` 'UNSPECIFIED' | 'SMALL' | 'MEDIUM'
- `filename` string

## Response `200`

A successful response

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-09-28** `3f573d3bf03f`: 2 info
  - added the new optional `query` request parameter `filename`
  - added the optional property `extensions` to the response with the `200` status
- **2025-05-08** `6b24249801ec`: 1 breaking
  - for the `query` request parameter `image_size`, default value `UNSPECIFIED` was added
- **2025-04-28** `f08be9b66e16`: 1 breaking
  - for the `query` request parameter `image_size`, default value `UNSPECIFIED` was removed
- **2025-02-08** `00bdccfc6283`: 1 breaking, 1 info
  - removed the media type `application/json` for the response with the status `default`
  - added the media type `text/plain` for the response with the status `default`
- **2023-11-14** `b4da81b65e0a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ncats/apis/ncbi-datasets-api/changes/taxonomy/taxon/:taxon/image/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)