---
title: "Search Retraction Watch"
method: GET
path: "/v1/sources/retraction-watch/search"
tags: ["Retraction Watch"]
---

# Search Retraction Watch

`GET /v1/sources/retraction-watch/search`

## Request

- Base URL: `https://api.assyro.com`
- URL: `https://api.assyro.com/v1/sources/retraction-watch/search`
- Auth: none declared

Check whether published papers were retracted, corrected, given an expression of concern or reinstated, in the Retraction Watch Database (about 73,000 notices, made open by Crossref, copied each working day). Give the DOI or PubMed ID of each paper (up to 25 in one call: check every paper an answer will rely on), or a title when neither is known. Each identifier gets a status (RETRACTED, EXPRESSION OF CONCERN, CORRECTED, REINSTATED, or no notice) with the notice's date, DOI and Retraction Watch's reasons. Never cite a retracted paper as support without saying it was retracted. No notice is not proof the paper stands: corrections and concerns are less complete than retractions.

## Query parameters

- `doi` string[]: DOIs of the papers to check, e.g. ["10.1155/2016/2641248"]. A doi.org link works.
- `pmid` string[]: PubMed IDs of the papers to check, e.g. ["27057550"].
- `title` string: Words of a paper's title, when no DOI or PMID is known; a title match must be confirmed before it is reported.
- `limit` integer: Title matches to return, default 5 (identifier lookups return every notice).

## Response `200`

Matching records.

- SearchResponse
  - `version` unknown, required
  - `source` SourceRef, required
    - `id` string, required
    - `label` string, required
    - `authority` string, required
  - `total` integer, nullable, required: Total matches the source reports, when it says.
  - `records` Record[], required
    - `id` string, required: The source's own identifier for the record.
    - `title` string, required
    - `url` string, required: The record's page at the source, to verify it.
    - `authority` string, required: Who published the record.
    - `snippet` string, nullable, required: The part of the record that matched; null where the licence allows only a link.
    - `publishedDate` string, nullable, required
    - `version` string, nullable, required: The edition or revision read.
    - `fields` object, nullable, required: The source's own fields; null where the licence allows only a link.
    - `asOf` string, nullable, required: The day Assyro's copy of the source was read (YYYY-MM-DD).
    - `attribution` string: The attribution the source's licence requires, on sources that require one.
  - `note` string
  - `summary` string[]

## Other responses

- `400`: The request is not valid: an unknown parameter or an argument the source refuses.
- `404`: No such source or record.
- `429`: Rate limited; retry after the Retry-After header.
- `503`: The source cannot answer from Assyro's copy right now.

---

[API](https://skmtc.dev/assyro/apis/assyro-public-data-api.md) - [All operations](https://skmtc.dev/assyro/apis/assyro-public-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/assyro/apis/assyro-public-data-api/revisions/c861290c9f47?raw)