---
title: "Get a revision history for a genome assembly by genome assembly accession"
method: GET
path: "/genome/accession/{accession}/revision_history"
tags: ["Genome"]
---

# Get a revision history for a genome assembly by genome assembly accession

`GET /genome/accession/{accession}/revision_history`

## Request

- Base URL: `https://api.ncbi.nlm.nih.gov/datasets/v2`
- URL: `https://api.ncbi.nlm.nih.gov/datasets/v2/genome/accession/{accession}/revision_history`
- Auth: API key in header `api-key`

Get a revision history, or list of all versions of a genome assembly, in JSON format.

## Path parameters

- `accession` string, required

## Response `200`

A successful response

- V2AssemblyRevisionHistory
  - `assembly_revisions` V2reportsAssemblyRevision[]
    - `genbank_accession` string
    - `refseq_accession` string
    - `assembly_name` string
    - `assembly_level` 'chromosome' | 'scaffold' | 'contig' | 'complete_genome'
    - `release_date` string
    - `submission_date` string
    - `sequencing_technology` string
    - `identical` boolean
  - `total_count` integer

## Other responses

- `default`: An unexpected error response.

## Changes

- **2025-05-08** `6b24249801ec`: 2 info
  - added the optional property `assembly_revisions/items/identical` to the response with the `200` status
  - the `assembly_level` response's property default value `chromosome` was added for the status `200`
- **2025-04-28** `f08be9b66e16`: 1 info
  - the `assembly_level` response's property default value `chromosome` was removed for the status `200`
- **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
  - added the optional property `assembly_revisions/items/release_date` to the response with the `200` status

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