---
title: "Get BioSample dataset reports by accession(s)"
method: GET
path: "/biosample/accession/{accessions}/biosample_report"
tags: ["BioSample"]
---

# Get BioSample dataset reports by accession(s)

`GET /biosample/accession/{accessions}/biosample_report`

Get BioSample dataset reports by accession(s). By default, in paged JSON format, but also available as tabular (accept: text/tab-separated-values) or json-lines (accept: application/x-ndjson)

## Path parameters

- `accessions` string[], required

## Response `200`

A successful response

- V2reportsBioSampleDataReportPage
  - `reports` V2reportsBioSampleDataReport[]
    - `accession` string
    - `last_updated` string
    - `publication_date` string
    - `submission_date` string
    - `sample_ids` V2reportsBioSampleId[]
      - `db` string
      - `label` string
      - `value` string
    - `description` V2reportsBioSampleDescription
      - `title` 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
      - `comment` string
    - `owner` V2reportsBioSampleOwner
      - `name` string
      - `contacts` V2reportsBioSampleContact[]
        - `lab` string
    - `models` string[]
    - `bioprojects` V2reportsBioProject[]
      - `accession` string
      - `title` string
      - `parent_accession` string
      - `parent_accessions` string[]
    - `package` string
    - `attributes` V2reportsBioSampleAttribute[]
      - `name` string
      - `value` string
    - `status` V2reportsBioSampleStatus
      - `status` string
      - `when` string
    - `age` string
    - `biomaterial_provider` string
    - `breed` string
    - `collected_by` string
    - `collection_date` string
    - `cultivar` string
    - `dev_stage` string
    - `ecotype` string
    - `geo_loc_name` string
    - `host` string
    - `host_disease` string
    - `identified_by` string
    - `ifsac_category` string
    - `isolate` string
    - `isolate_name_alias` string
    - `isolation_source` string
    - `lat_lon` string
    - `project_name` string
    - `sample_name` string
    - `serovar` string
    - `sex` string
    - `source_type` string
    - `strain` string
    - `sub_species` string
    - `tissue` string
    - `serotype` string
  - `total_count` integer
  - `next_page_token` 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

## 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/e5d4400c8e5d/schema)