Retraction & updates

The Entitlement API provides a summary of updates to the Document for every DOI where information is available at Crossref or Retraction Watch. This information is provided inside the "updates" property of the Entitlement Object.

Updates API Endpoint

A separate Updates API is provided for retrieving updates to one or more documents without performing any entitlement checks. The endpoint is available at:

POST https://entitlements.prod.getft.io/v2.1/updates

Request Body

{
  "dois": ["10.10/1234", "..."]
}

The request body accepts one or more DOIs inside a "dois" array. A maximum of 100 DOIs can be requested at once.

Response Body

{
  "documents": [
    {
      "doi": "10.1234/1111",
      "statusCode": 200,
      "updates": [
        {
          "updateDoi": "10.1234/1111",
          "source": "crossref",
          "updateType": "updateType",
          "updateDate": "updateDate",
          "reasons": ["reasons"],
          "urls": ["urls"]
        }
      ]
    }
  ]
}

The response body is a partial Entitlement Object and the "updates" key is always present, irregardless of whether or not Retraction & Errata is enabled for the integrator.

Document Status Page

GetFTR provides an additional service, Document Status Page, which shows the history of changes to the document in timeline format.

To access this page for a specific document add the DOI after the following prefix:

https://document-status.getft.io/doi/{doi}

For example, the link to the Document Status Page for "10.3389/fenvs.2022.983136" DOI is the following: https://document-status.getft.io/doi/10.3389/fenvs.2022.983136