---
title: "Get an organelle data report by taxon"
method: GET
path: "/organelle/taxon/{taxons}/dataset_report"
tags: ["Organelle"]
---

# Get an organelle data report by taxon

`GET /organelle/taxon/{taxons}/dataset_report`

## Request

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

Get an organelle data report  in JSON format.

## Path parameters

- `taxons` string[], required

## Query parameters

- `organelle_types` V2reportsOrganelleType[]
- `first_release_date` string, date-time
- `last_release_date` string, date-time
- `tax_exact_match` boolean
- `sort.field` string
- `sort.direction` 'SORT_DIRECTION_UNSPECIFIED' | 'SORT_DIRECTION_ASCENDING' | 'SORT_DIRECTION_DESCENDING'
- `returned_content` 'COMPLETE' | 'ASSM_ACC'
- `page_size` integer
- `page_token` string
- `table_format` 'ORGANELLE_TABLE_FORMAT_NO_TABLE' | 'SUMMARY'
- `include_tabular_header` 'INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY' | 'INCLUDE_TABULAR_HEADER_ALWAYS' | 'INCLUDE_TABULAR_HEADER_NEVER'

## Response `200`

A successful response

- V2reportsOrganelleDataReports
  - `messages` V2reportsMessage[]
    - `error` V2reportsError
      - `assembly_error_code` 'UNKNOWN_ASSEMBLY_ERROR_CODE' | 'INVALID_BIOPROJECT_IDS' | 'NO_ASSEMBLIES_FOR_BIOPROJECTS' | 'INVALID_TAXON' | 'MISSING_SEARCH_FIELD' | 'INVALID_BIOSAMPLE_IDS' | 'NO_ASSEMBLIES_FOR_BIOSAMPLE_IDS' | 'NO_ASSEMBLIES_FOR_ASSEMBLY_NAMES' | 'INVALID_WGS_ACCESSIONS' | 'NO_ASSEMBLIES_FOR_WGS_ACCESSIONS'
      - `gene_error_code` 'UNKNOWN_GENE_ERROR_CODE' | 'INCOMPLETE_LOOKUP_SYMBOL' | 'INVALID_TAXON_GENE_ARGUMENT'
      - `organelle_error_code` 'UNKNOWN_ORGANELLE_ERROR_CODE' | 'INVALID_ORGANELLE_TAXON' | 'NO_ORGANELLES_FOR_ACCESSION'
      - `virus_error_code` 'UNKNOWN_VIRUS_ERROR_CODE'
      - `taxonomy_error_code` 'UNKNOWN_TAXONOMY_ERROR_CODE' | 'INVALID_TAXONOMY_TAXON'
      - `sequence_error_code` 'UNKNOWN_SEQUENCE_ERROR_CODE' | 'INVALID_SEQUENCE_ACCESSION'
      - `reason` string
      - `message` string
      - `invalid_identifiers` string[]
    - `warning` V2reportsWarning
      - `gene_warning_code` 'UNKNOWN_GENE_WARNING_CODE' | 'ACCESSION_VERSION_MISMATCH' | 'REPLACED_GENE_ID' | 'DISCONTINUED_GENE_ID' | 'UNRECOGNIZED_GENE_ID' | 'UNRECOGNIZED_GENE_SYMBOL' | 'UNRECOGNIZED_ACCESSION' | 'UNRECOGNIZED_TAX_TOKEN' | 'NO_GENE_ANNOTATION_FOUND' | 'ABOVE_SPECIES_TAXON'
      - `reason` string
      - `message` string
      - `replaced_id` V2reportsWarningReplacedId
        - `requested` string
        - `returned` string
      - `unrecognized_identifier` string
  - `reports` V2reportsOrganelle[]
    - `description` 'ORGANELLE_TYPE_UNKNOWN' | 'Mitochondrion' | 'Chloroplast' | 'Plastid' | 'Kinetoplast' | 'Apicoplast' | 'Chromatophore' | 'Cyanelle'
    - `genbank` V2reportsSequenceInformation
      - `accession` string
      - `submission_date` string
      - `submitter` string
    - `refseq` V2reportsSequenceInformation
      - `accession` string
      - `submission_date` string
      - `submitter` string
    - `organism` V2reportsOrganism
      - `tax_id` integer
      - `sci_name` string
      - `organism_name` string
      - `common_name` string
      - `lineage` V2reportsLineageOrganism[]
        - `tax_id` integer
        - `name` string
      - `strain` string
      - `pangolin_classification` string
      - `infraspecific_names` V2reportsInfraspecificNames
        - `breed` string
        - `cultivar` string
        - `ecotype` string
        - `isolate` string
        - `sex` string
        - `strain` string
    - `bioprojects` V2reportsBioProject[]
      - `accession` string
      - `title` string
      - `parent_accession` string
      - `parent_accessions` string[]
    - `biosample` V2reportsOrganelleBiosample
      - `accession` string
    - `gene_counts` V2reportsOrganelleGeneCounts
      - `total` integer
      - `protein_coding` integer
      - `rrna` integer
      - `trna` integer
      - `lncrna` integer
    - `length` integer
    - `topology` 'TOPOLOGY_UNKNOWN' | 'Circular' | 'Linear' | 'Tandem'
    - `gene_count` integer
  - `total_count` integer
  - `next_page_token` string

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-08-06** `e5d4400c8e5d`: 3 info
  - added the media type `application/x-ndjson` for the response with the status `200`
  - added the media type `text/tab-separated-values` for the response with the status `200`
  - added the optional property `messages/items/error/sequence_error_code` to the response with the `200` status
- **2025-05-08** `6b24249801ec`: 4 breaking, 8 info
  - for the `query` request parameter `include_tabular_header`, default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was added
  - for the `query` request parameter `returned_content`, default value `COMPLETE` was added
  - for the `query` request parameter `sort.direction`, default value `SORT_DIRECTION_UNSPECIFIED` was added
  - for the `query` request parameter `table_format`, default value `ORGANELLE_TABLE_FORMAT_NO_TABLE` was added
  - …8 more
- **2025-04-28** `f08be9b66e16`: 4 breaking, 8 info
  - for the `query` request parameter `include_tabular_header`, default value `INCLUDE_TABULAR_HEADER_FIRST_PAGE_ONLY` was removed
  - for the `query` request parameter `returned_content`, default value `COMPLETE` was removed
  - for the `query` request parameter `sort.direction`, default value `SORT_DIRECTION_UNSPECIFIED` was removed
  - for the `query` request parameter `table_format`, default value `ORGANELLE_TABLE_FORMAT_NO_TABLE` was removed
  - …8 more
- **2025-02-08** `00bdccfc6283`: 1 info
  - endpoint added

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