---
title: "Get a biocollection report by collection ID or code"
method: GET
path: "/taxonomy/biocollections/id/{collection_ids}/dataset_report"
tags: ["Taxonomy"]
---

# Get a biocollection report by collection ID or code

`GET /taxonomy/biocollections/id/{collection_ids}/dataset_report`

## Request

- Base URL: `https://api.ncbi.nlm.nih.gov/datasets/v2`
- URL: `https://api.ncbi.nlm.nih.gov/datasets/v2/taxonomy/biocollections/id/{collection_ids}/dataset_report`
- Auth: API key in header `api-key`

Get a biocollection report by collection ID or code in JSON format.

## Path parameters

- `collection_ids` string[], required

## Query parameters

- `page_size` integer
- `page_token` string
- `sort.field` string
- `sort.direction` 'SORT_DIRECTION_UNSPECIFIED' | 'SORT_DIRECTION_ASCENDING' | 'SORT_DIRECTION_DESCENDING'

## Response `200`

A successful response

- V2reportsBiocollectionsReportPage
  - `reports` V2reportsGetBiocollectionsReport[]
    - `institution` V2reportsBiocollectionInstitution
      - `name` string
      - `country` string
      - `address` string
      - `url` string
      - `comments` string
      - `bio_collections` V2reportsBiocollection[]
        - `bio_collection_id` string, int64
        - `code` string
        - `ncbi_unique_code` string
        - `name` string
        - `type` string
        - `comments` string
  - `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
  - `total_count` integer
  - `next_page_token` string

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-09-09** `784ab37582ce`: 1 info
  - endpoint added

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