{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/defianceinternational-io/json-schema/defianceinternational-io-list-research-records-200-schema.json",
  "title": "listResearchRecords.200",
  "description": "The public research register page. Indexed metadata only, not scientific review.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/defianceinternational-io-openapi.yml#/components/schemas/listResearchRecords.200",
  "anyOf": [
    {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "publicId": {
                "type": "string",
                "description": "Public id of the work."
              },
              "title": {
                "type": "string"
              },
              "authors": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "doi": {
                "type": "string",
                "description": "Display DOI, or an empty string when the work has none."
              },
              "sourceUrl": {
                "type": "string",
                "description": "Link to the authoritative source record."
              },
              "workType": {
                "type": "string",
                "enum": [
                  "journal-article",
                  "posted-content",
                  "proceedings-article",
                  "report",
                  "trial-report",
                  "other"
                ]
              },
              "lifecycle": {
                "type": "string",
                "enum": [
                  "no-admitted-signal-observed",
                  "updated",
                  "corrected",
                  "retracted",
                  "related"
                ]
              },
              "reviewState": {
                "type": "string",
                "enum": [
                  "indexed_metadata",
                  "metadata_reviewed"
                ]
              },
              "sourcePublishedAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Timestamp text exactly as the register stores it; no format is promised."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Publication time the source states, when it states one."
              },
              "firstSeenAt": {
                "type": "string",
                "description": "First time the register observed the work."
              },
              "updatedAt": {
                "type": "string",
                "description": "Source update time, or the observation time when the source states none."
              },
              "outlet": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "publicId": {
                        "type": "string",
                        "description": "Public id of the source outlet."
                      },
                      "title": {
                        "type": "string",
                        "description": "Source outlet name."
                      }
                    },
                    "required": [
                      "publicId",
                      "title"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The single source outlet, or null when there is none or outlets conflict."
              },
              "outletConflict": {
                "type": "boolean",
                "description": "True when snapshots name more than one outlet; the outlet is then withheld."
              },
              "provider": {
                "type": "string",
                "description": "Provider key of the latest snapshot."
              },
              "topics": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "enum": [
                        "life-sciences",
                        "chemistry",
                        "chemistry-primary",
                        "medicine-health",
                        "product-adjacent-biomedical",
                        "research-format",
                        "cell-biology",
                        "molecular-biology",
                        "biochemistry",
                        "genetics-genomics",
                        "microbiology-infectious-disease",
                        "virology",
                        "immunology",
                        "neuroscience",
                        "physiology",
                        "oncology",
                        "endocrinology-metabolism",
                        "regenerative-medicine",
                        "stem-cell-biology",
                        "exosome-biology",
                        "chemical-sequence-protein-science",
                        "systems-biology",
                        "biotechnology",
                        "medicinal-chemistry",
                        "analytical-chemistry",
                        "pharmaceutical-science",
                        "pharmacology",
                        "pharmacokinetics",
                        "clinical-medicine",
                        "clinical-trials",
                        "diagnostics",
                        "toxicology-safety",
                        "formulation",
                        "manufacturing-quality",
                        "product-testing-materials",
                        "bioinformatics",
                        "computational-biology",
                        "biomedical-engineering",
                        "medical-imaging",
                        "journal-article"
                      ],
                      "description": "Topic registry key."
                    },
                    "label": {
                      "type": "string",
                      "description": "Topic label."
                    }
                  },
                  "required": [
                    "key",
                    "label"
                  ],
                  "additionalProperties": false
                }
              },
              "sourceReviewStatus": {
                "type": "string",
                "enum": [
                  "peer_reviewed",
                  "preprint",
                  "trial_record",
                  "unknown"
                ]
              }
            },
            "required": [
              "publicId",
              "title",
              "authors",
              "doi",
              "sourceUrl",
              "workType",
              "lifecycle",
              "reviewState",
              "sourcePublishedAt",
              "firstSeenAt",
              "updatedAt",
              "outlet",
              "outletConflict",
              "provider",
              "topics",
              "sourceReviewStatus"
            ],
            "additionalProperties": false,
            "description": "One indexed work in the public register."
          }
        },
        "page": {
          "type": "object",
          "properties": {
            "number": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9007199254740991,
              "description": "Requested page, starting at 1."
            },
            "size": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9007199254740991,
              "description": "Page size applied."
            },
            "total": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Matching records."
            },
            "pages": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Pages at this size."
            },
            "snapshot": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^v1\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Opaque cursor that holds later pages to the same register snapshot; null when the register holds no work."
            }
          },
          "required": [
            "number",
            "size",
            "total",
            "pages",
            "snapshot"
          ],
          "additionalProperties": false
        },
        "coverage": {
          "type": "object",
          "properties": {
            "provider": {
              "type": "string",
              "const": "multi-source"
            },
            "coverageLabel": {
              "type": "string",
              "const": "Admitted multi-source research surveillance population"
            },
            "observedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "Timestamp text exactly as the register stores it; no format is promised."
                },
                {
                  "type": "null"
                }
              ],
              "description": "Latest successful feed read, or null when no feed has succeeded."
            },
            "latestSuccessAt": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "Timestamp text exactly as the register stores it; no format is promised."
                },
                {
                  "type": "null"
                }
              ],
              "description": "Latest successful feed read, or null when no feed has succeeded."
            },
            "stale": {
              "type": "boolean",
              "description": "True when no feed has succeeded within the freshness window."
            },
            "partial": {
              "type": "boolean",
              "description": "True when a required feed is limited."
            },
            "worksObserved": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Distinct works with at least one observed snapshot."
            },
            "publicWorks": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Admitted, unsuppressed works shown in the public register."
            },
            "outletsObserved": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Source outlets named by the latest snapshot of a public work."
            },
            "unresolvedCollisions": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Identity collisions awaiting review."
            },
            "excludedRecords": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Provider records excluded across all runs."
            },
            "failedRecords": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Provider records that failed across all runs."
            },
            "journalRegistry": {
              "type": "object",
              "properties": {
                "state": {
                  "type": "string",
                  "description": "State of the source registry feed, or not-started."
                },
                "completedAt": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Timestamp text exactly as the register stores it; no format is promised."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "When the source registry last completed a sync."
                }
              },
              "required": [
                "state",
                "completedAt"
              ],
              "additionalProperties": false
            },
            "worksFeed": {
              "type": "object",
              "properties": {
                "state": {
                  "type": "string",
                  "description": "State of the works discovery feed, or not-started."
                },
                "windowStart": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Timestamp text exactly as the register stores it; no format is promised."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Start of the current discovery window."
                },
                "windowEnd": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Timestamp text exactly as the register stores it; no format is promised."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "End of the current discovery window."
                }
              },
              "required": [
                "state",
                "windowStart",
                "windowEnd"
              ],
              "additionalProperties": false
            },
            "requiredFeeds": {
              "type": "object",
              "properties": {
                "total": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                "healthy": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                "limited": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "total",
                "healthy",
                "limited"
              ],
              "additionalProperties": false,
              "description": "Required feeds: total = healthy + limited."
            },
            "coverageLimitations": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "description": "Provider key of the limited feed."
                  },
                  "feed": {
                    "type": "string",
                    "description": "Provider key and endpoint class of the limited feed."
                  },
                  "role": {
                    "description": "Declared role of the feed, when it has one.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "state": {
                    "type": "string",
                    "description": "Current state of the feed."
                  },
                  "reason": {
                    "description": "Safe reason the feed is limited, when one is recorded.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "required": {
                    "type": "boolean",
                    "description": "Whether the feed is required for complete coverage."
                  }
                },
                "required": [
                  "provider",
                  "feed",
                  "role",
                  "state",
                  "reason",
                  "required"
                ],
                "additionalProperties": false,
                "description": "One feed that currently limits coverage."
              },
              "description": "Every current feed that is limited."
            }
          },
          "required": [
            "provider",
            "coverageLabel",
            "observedAt",
            "latestSuccessAt",
            "stale",
            "partial",
            "worksObserved",
            "publicWorks",
            "outletsObserved",
            "unresolvedCollisions",
            "excludedRecords",
            "failedRecords",
            "journalRegistry",
            "worksFeed",
            "requiredFeeds",
            "coverageLimitations"
          ],
          "additionalProperties": false,
          "description": "Coverage of the admitted research surveillance register. Indexed metadata only."
        },
        "facets": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "key": {
                "type": "string",
                "description": "Topic registry key."
              },
              "label": {
                "type": "string",
                "description": "Topic label."
              },
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991,
                "description": "Matching works under the topic."
              }
            },
            "required": [
              "key",
              "label",
              "count"
            ],
            "additionalProperties": false
          },
          "description": "Every registry topic with its matching work count, sorted by label."
        },
        "researchUseOnly": {
          "type": "string",
          "description": "The boundary statement, stated once at the top level.",
          "pattern": "^Research use only\\. Not for human consumption\\.$"
        }
      },
      "required": [
        "items",
        "page",
        "coverage",
        "facets",
        "researchUseOnly"
      ],
      "additionalProperties": false,
      "description": "A page of indexed works (entity work or all)."
    },
    {
      "type": "object",
      "properties": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "publicId": {
                "type": "string",
                "description": "Public id of the trial registry record."
              },
              "title": {
                "type": "string"
              },
              "authors": {
                "maxItems": 0,
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "doi": {
                "type": "string",
                "const": ""
              },
              "sourceUrl": {
                "type": "string",
                "description": "Link to the registry record."
              },
              "workType": {
                "type": "string",
                "const": "trial-report"
              },
              "lifecycle": {
                "type": "string",
                "const": "no-admitted-signal-observed"
              },
              "reviewState": {
                "type": "string",
                "const": "indexed_metadata"
              },
              "sourcePublishedAt": {
                "type": "null"
              },
              "firstSeenAt": {
                "type": "string",
                "description": "Latest observation time of the registry record."
              },
              "updatedAt": {
                "type": "string",
                "description": "Registry update time, or the observation time when the registry states none."
              },
              "outlet": {
                "type": "object",
                "properties": {
                  "publicId": {
                    "type": "string",
                    "const": "clinicaltrials"
                  },
                  "title": {
                    "type": "string",
                    "const": "ClinicalTrials.gov registry"
                  }
                },
                "required": [
                  "publicId",
                  "title"
                ],
                "additionalProperties": false
              },
              "provider": {
                "type": "string",
                "const": "clinicaltrials"
              },
              "topics": {
                "maxItems": 0,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string",
                      "enum": [
                        "life-sciences",
                        "chemistry",
                        "chemistry-primary",
                        "medicine-health",
                        "product-adjacent-biomedical",
                        "research-format",
                        "cell-biology",
                        "molecular-biology",
                        "biochemistry",
                        "genetics-genomics",
                        "microbiology-infectious-disease",
                        "virology",
                        "immunology",
                        "neuroscience",
                        "physiology",
                        "oncology",
                        "endocrinology-metabolism",
                        "regenerative-medicine",
                        "stem-cell-biology",
                        "exosome-biology",
                        "chemical-sequence-protein-science",
                        "systems-biology",
                        "biotechnology",
                        "medicinal-chemistry",
                        "analytical-chemistry",
                        "pharmaceutical-science",
                        "pharmacology",
                        "pharmacokinetics",
                        "clinical-medicine",
                        "clinical-trials",
                        "diagnostics",
                        "toxicology-safety",
                        "formulation",
                        "manufacturing-quality",
                        "product-testing-materials",
                        "bioinformatics",
                        "computational-biology",
                        "biomedical-engineering",
                        "medical-imaging",
                        "journal-article"
                      ],
                      "description": "Topic registry key."
                    },
                    "label": {
                      "type": "string",
                      "description": "Topic label."
                    }
                  },
                  "required": [
                    "key",
                    "label"
                  ],
                  "additionalProperties": false
                }
              },
              "sourceReviewStatus": {
                "type": "string",
                "const": "trial_record"
              }
            },
            "required": [
              "publicId",
              "title",
              "authors",
              "doi",
              "sourceUrl",
              "workType",
              "lifecycle",
              "reviewState",
              "sourcePublishedAt",
              "firstSeenAt",
              "updatedAt",
              "outlet",
              "provider",
              "topics",
              "sourceReviewStatus"
            ],
            "additionalProperties": false,
            "description": "One trial registry record in the public register."
          }
        },
        "page": {
          "type": "object",
          "properties": {
            "number": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9007199254740991,
              "description": "Requested page, starting at 1."
            },
            "size": {
              "type": "integer",
              "minimum": 1,
              "maximum": 9007199254740991,
              "description": "Page size applied."
            },
            "total": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Matching records."
            },
            "pages": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Pages at this size."
            },
            "snapshot": {
              "type": "null"
            }
          },
          "required": [
            "number",
            "size",
            "total",
            "pages",
            "snapshot"
          ],
          "additionalProperties": false
        },
        "coverage": {
          "type": "object",
          "properties": {
            "provider": {
              "type": "string",
              "const": "multi-source"
            },
            "coverageLabel": {
              "type": "string",
              "const": "Admitted multi-source research surveillance population"
            },
            "observedAt": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "Timestamp text exactly as the register stores it; no format is promised."
                },
                {
                  "type": "null"
                }
              ],
              "description": "Latest successful feed read, or null when no feed has succeeded."
            },
            "latestSuccessAt": {
              "anyOf": [
                {
                  "type": "string",
                  "description": "Timestamp text exactly as the register stores it; no format is promised."
                },
                {
                  "type": "null"
                }
              ],
              "description": "Latest successful feed read, or null when no feed has succeeded."
            },
            "stale": {
              "type": "boolean",
              "description": "True when no feed has succeeded within the freshness window."
            },
            "partial": {
              "type": "boolean",
              "description": "True when a required feed is limited."
            },
            "worksObserved": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Distinct works with at least one observed snapshot."
            },
            "publicWorks": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Admitted, unsuppressed works shown in the public register."
            },
            "outletsObserved": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Source outlets named by the latest snapshot of a public work."
            },
            "unresolvedCollisions": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Identity collisions awaiting review."
            },
            "excludedRecords": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Provider records excluded across all runs."
            },
            "failedRecords": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Provider records that failed across all runs."
            },
            "journalRegistry": {
              "type": "object",
              "properties": {
                "state": {
                  "type": "string",
                  "description": "State of the source registry feed, or not-started."
                },
                "completedAt": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Timestamp text exactly as the register stores it; no format is promised."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "When the source registry last completed a sync."
                }
              },
              "required": [
                "state",
                "completedAt"
              ],
              "additionalProperties": false
            },
            "worksFeed": {
              "type": "object",
              "properties": {
                "state": {
                  "type": "string",
                  "description": "State of the works discovery feed, or not-started."
                },
                "windowStart": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Timestamp text exactly as the register stores it; no format is promised."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Start of the current discovery window."
                },
                "windowEnd": {
                  "anyOf": [
                    {
                      "type": "string",
                      "description": "Timestamp text exactly as the register stores it; no format is promised."
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "End of the current discovery window."
                }
              },
              "required": [
                "state",
                "windowStart",
                "windowEnd"
              ],
              "additionalProperties": false
            },
            "requiredFeeds": {
              "type": "object",
              "properties": {
                "total": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                "healthy": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                },
                "limited": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991
                }
              },
              "required": [
                "total",
                "healthy",
                "limited"
              ],
              "additionalProperties": false,
              "description": "Required feeds: total = healthy + limited."
            },
            "coverageLimitations": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string",
                    "description": "Provider key of the limited feed."
                  },
                  "feed": {
                    "type": "string",
                    "description": "Provider key and endpoint class of the limited feed."
                  },
                  "role": {
                    "description": "Declared role of the feed, when it has one.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "state": {
                    "type": "string",
                    "description": "Current state of the feed."
                  },
                  "reason": {
                    "description": "Safe reason the feed is limited, when one is recorded.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "required": {
                    "type": "boolean",
                    "description": "Whether the feed is required for complete coverage."
                  }
                },
                "required": [
                  "provider",
                  "feed",
                  "role",
                  "state",
                  "reason",
                  "required"
                ],
                "additionalProperties": false,
                "description": "One feed that currently limits coverage."
              },
              "description": "Every current feed that is limited."
            }
          },
          "required": [
            "provider",
            "coverageLabel",
            "observedAt",
            "latestSuccessAt",
            "stale",
            "partial",
            "worksObserved",
            "publicWorks",
            "outletsObserved",
            "unresolvedCollisions",
            "excludedRecords",
            "failedRecords",
            "journalRegistry",
            "worksFeed",
            "requiredFeeds",
            "coverageLimitations"
          ],
          "additionalProperties": false,
          "description": "Coverage of the admitted research surveillance register. Indexed metadata only."
        },
        "researchUseOnly": {
          "type": "string",
          "description": "The boundary statement, stated once at the top level.",
          "pattern": "^Research use only\\. Not for human consumption\\.$"
        }
      },
      "required": [
        "items",
        "page",
        "coverage",
        "researchUseOnly"
      ],
      "additionalProperties": false,
      "description": "A page of trial registry records (entity trial)."
    }
  ]
}