Article DOI Lookup Endpoint (LibKey)

The LibKey Article DOI Lookup Endpoint allows your application to determine whether an article is available at browzine.com, and information about the article to produce a LibKey Direct PDF Link as well as produce a link to the article within the context of the issue in BrowZine at your library.

Submit a GET request against this endpoint with a DOI and your application will get a response indicating if that article can be found in the designated library within BrowZine/LibKey.  If the DOI matches the DOI of an article in the Third Iron system, the response will contain an "Article Result" JSON object with metadata about the article reference by the specified DOI.

Third Iron Journal Availability Request:

GET

/public/v1/libraries/:library_id/articles/doi/:article_doi

LibKey Article DOI Lookup Response:

The LibKey Article DOI Lookup endpoint responds with a JSON object if the article is found in the LibKey system at all.  If it is found, this indicates that LibKey recognizes this article DOI.  The accompanying metadata then will indicate if it is "availableThroughBrowZine" for the given library.  If it is, additional metadata about the article, including the browzineWebLink is provided.   The structure of the response overall is described in the following tables.

Response Object:

Article Result:

An article result represents an article that the LibKey system is aware of.  Responses from the "DOI lookup" endpoint then describe articles that have DOI's that LibKey is aware of but are not in the specified BrowZine Library (:library_id) as well as articles that are within that library.  A response indicates whether the article referenced by a DOI is available at the specified library by setting the article result's "availableThroughBrowZine" property to true when the article is available at the library, and false when it is not.

The full list of properties that may appear on a journal result are described in detail in the table below:

If you utilize the optional ?include=journal parameter, you will also receive journal information.  The list of properties appearing when this is done is included below:

Example Request, no include:

GET /public/v1/libraries/73/articles/doi/10.1056/NEJMe1702728

Example Response, no include:

{
    "data": {
        "id": 76582654,
        "type": "articles",
        "title": "Assessment of Stable Coronary Lesions",
        "date": "2017-05-11",
        "authors": "Bhatt, Deepak L.",
        "inPress": false,
        "fullTextFile": "https://libkey.io/libraries/73/articles/143256905/full-text-file",
		"contentLocation": "https://libkey.io/libraries/73/articles/143256905",
        "availableThroughBrowzine": true,
        "startPage": "1879",
        "endPage": "1881",
        "browzineWebLink": "https://browzine.com/libraries/73/journals/10292/issues/36167007?showArticleInContext=doi:10.1056/NEJMe1702728"
    }
}

Example Request, with ?include=journal

GET /public/v1/libraries/73/articles/doi/10.1056/NEJMe1708704?include=journal

Example Response, with ?include=journal

{
    "data": {
        "id": 143256905,
        "type": "articles",
        "title": "From Last to First — Could the U.S. Health Care System Become the Best in the World?",
        "date": "2017-09-07",
        "authors": "Schneider, Eric C.; Squires, David",
        "inPress": false,
        "fullTextFile": "https://libkey.io/libraries/73/articles/143256905/full-text-file",
		"contentLocation": "https://libkey.io/libraries/73/articles/143256905",
        "availableThroughBrowzine": true,
        "startPage": "901",
        "endPage": "904",
        "browzineWebLink": "https://browzine.com/libraries/73/journals/10292/issues/99568218?showArticleInContext=doi:10.1056/NEJMp1708704",
        "relationships": {
            "journal": {
                "data": {
                    "type": "journals",
                    "id": 10292
                }
            }
        }
    },
    "included": [
        {
            "id": 10292,
            "type": "journals",
            "title": "New England Journal of Medicine (NEJM)",
            "issn": "00284793",
            "sjrValue": 14.619,
            "coverImageUrl": "https://assets.thirdiron.com/images/covers/0028-4793.png",
            "browzineEnabled": true,
            "browzineWebLink": "https://browzine.com/libraries/73/journals/10292"
        }
    ]
}