Okapi Okapi

/datasets/v1/* → version retirement

NCBI Datasets API

Stopped working

NCBI Datasets API endpoints under /datasets/v1/* stopped working on December 31, 2024. The provider retired the v1 API, older command-line interface versions, and the v1 Python library. Requests sent to these endpoints after that date fail.


Calls it hits

  • /datasets/v1/*

What to use instead of these calls

Update your requests to target the v2 API instead, such as using GET /datasets/v2/genome/accession/{accessions}/dataset_report.

In NCBI Datasets API's words

At this time, the v1 API, the command-line interface (CL I ) version 13 and older versions, and the Python library v1 will be deprecated and thus no longer supported for bug fixes or updates. Effective December 31, 2024, these will no longer be available for use.

NCBI Datasets API, Announcement

Facts

API
NCBI Datasets API api.ncbi.nlm.nih.gov
Kind
Version retirement
Announced
February 20, 2024
Takes effect
December 31, 2024
Calls after that day
Fail
Source
Announcement
Last updated
Verified
, against NCBI Datasets API's own pages

Questions

When does this change take effect?

Calls to /datasets/v1/* on NCBI Datasets API stopped working on December 31, 2024.

What happens to calls after December 31, 2024?

They have failed since December 31, 2024.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


You fixed this one by hand.

Okapi opens the pull request with the fix before the next breaking change reaches your code.

Add to GitHub