Retration detailed metadata

Hello Crossref,

the blog article “News: Crossref and Retraction Watch” ( ) shows an image of metadata on retractions such as “retraction-date”, “retraction-nature”, “source” of retraction notice and “reason”.

I cannot find those information in the json metadata I retrieve from Rest API. Even for the example provided in the blog article I cannot reproduce the information.

How can the detailed information on retractions be retrieved?
Thank you very much in advance!

Hi Eva,

Currently, the Retraction Watch data is only available via our Labs API, not our production REST API.

Initially it’s available as a .csv file which you can download using the following request:{your-email-address}

The Labs API also includes the Retraction Watch data in the /works route for works which have retractions that were identified by Retraction Watch. For example:{your-email-address}

We do plan to eventually incorporate the Retraction Watch data into a fully-supported production API.



Dear Shayn,
thank you very much! What does it mean for me that the information are only available via the Labs API? Should I not use the Labs API as it is only for Crossref developers? Are the information provided by Labs API somehow less reliable?
Thank you for your reply!

Hi Eva,

The Labs API is a wrapper around our production API - it proxies the result from the live API and folds additional experimental content into what comes back. It might be a little less reliable than our other APIs in terms of uptime, but it’s not bad!

It’s not just for developers so you’re welcome to use it and we’d encourage you to do so if you’re interested in the Retraction Watch data at this point.

We use it to try things out, for ourselves and for the community e.g. adding data on DOI resolutions, adding retraction data, before we integrate these into our REST API. The data in it might change without warning if we do use it to try out new stuff. That said, the retraction data in there is being updated each time we get a new file from Retraction Watch so it’s a good resource to look at that before we integrate it into our production APIs.

Let us know if you have more questions!


Crossref provides a REST API that allows you to access their metadata, but the availability of specific fields depends on how the metadata for a particular article is registered by the publisher. Not all publishers may include detailed retraction information in the metadata they deposit with Crossref. Crossref provides documentation on their metadata schema. Make sure to review the documentation to see if the fields you are looking for are part of the standard schema. If the information you need is not available in the Crossref metadata, you might want to contact the publisher directly. Publishers are responsible for depositing accurate and comprehensive metadata, and they may be able to provide you with the specific retraction details.

Hi Shayn

Is it possible to also provide the new versions you receive from Retraction Watch using the CVS download url? As far as I can see, the latest retractions in that download file are from end of September



Or, alternatively, is there a specific filter I can use to get all retracted works? Does the following query also include Retraction Watch marked entries?



Hi Marc,

I asked one of our Labs team developers to look into the csv file, and he clarified that the Retraction Watch csv data is updated every working day. And he gave this example from the current file:

I just downloaded the most recent file and saw this entry, as an example: 10.1080/13625187.2023.2283990, which is a retraction dated 11/30/2023 0:00 (column K).

There isn’t a filter that will return items with Retraction Watch updates at this point in time. “filter=update-type:retraction” only returns updates asserted by the publisher using Crossmark metadata. We hope to add filtering capacity once the Retraction Watch data is moved over to the production API.


1 Like

Hi Shayn,

Thanks very much, I must have been sleeping :smiley: