Preprint matching

Preprint servers can make use of metadata based lookups on the /entitlements and /updates endpoints. This enables preprint servers to add a GetFTR link to the version of record from the preprint where the user’s institution entitles them, or content is open or freely available, ensuring the researcher is using the latest version in their research. When enabled, GetFTR can also supply retraction and update information for the version of record.

Metadata based lookups

DOI objects can be sent in the request to make metadata based lookups. For a document to match against the metadata, it must fulfill the following criteria:

• The title has to have a high similarity score to the title provided in the request (fuzzy search)
• The journal must match the journal title in the request (if it is provided)
• At least one of the authors must match the author names in the request (if they are provided)
• The publication year must be the same or later than the one in the request (if it is provided)
• The DOI must be different than the preprint DOI in the request (if it is provided)

If a preprint has its own DOI that is different from the published version’s, it should be supplied in the "preprintDoi" property, to make sure it will be excluded from the search results.

Request Body

{
  "dois": [
    {
      "title": "Effects of Vitamin C",
      "journal": "Journal of Medicine",
      "authors": ["John Doe", "Jane Doe"],
      "year": 2020,
      "uid": "b2d8bfea-050e-4293-af31-725815a1fa8b"
    },
    {
      "title": "Semiconductors in chip manufacturing",
      "preprintDoi": "10.10/1111-preprint",
      "uid": "fb64fcc0-3e5e-479f-a34e-f8af5f8ce2a9"
    }
  ]
}

When the request contains multiple DOI objects, all of them should include a "uid", so the results in the response can be mapped to the searched documents.

Response Body

{
  "documents": [
    {
      "uid": "b2d8bfea-050e-4293-af31-725815a1fa8b",
      "doi": "unknown",
      "statusCode": 404
    },
    {
      "uid": "fb64fcc0-3e5e-479f-a34e-f8af5f8ce2a9",
      "doi": "10.10/1111",
      "statusCode": 200,
      "entitled": "no",
      "accessType": "paid",
      "source": "service_request",
      "document": "https://link-to-content-on-publisher-platform.com",
      "av": [],
      "updates": [],
      "licenses": []
    }
  ]
}

If we can’t find the published version of a document based on the supplied metadata, the response will contain an "unknown" DOI with status code 404.