{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/defianceinternational-io/json-schema/defianceinternational-io-list-studies-v2-200-schema.json",
  "title": "listStudiesV2.200",
  "description": "One cursor page of the study library.",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/defianceinternational-io-openapi.yml#/components/schemas/listStudiesV2.200",
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "number",
      "const": 2
    },
    "projectionRevision": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$",
      "description": "The projection revision the answer was read from, 64 lower-case hex digits. Every page of one walk names the same revision."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "description": "The stable public identifier of the record."
          },
          "title": {
            "type": "string"
          },
          "citation": {
            "type": "object",
            "properties": {
              "authors": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "journal": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "year": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": -9007199254740991,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "publicationDate": {
                "description": "The stored publication day, or null when only a year or nothing is known.",
                "type": [
                  "string",
                  "null"
                ]
              },
              "pmid": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "doi": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": "string",
                "description": "The PubMed or DOI resolver URL of the record, or the empty string when neither is well formed."
              },
              "pubmedConfirmed": {
                "type": "boolean",
                "description": "True only when the displayed PMID is the identifier the PubMed receipt confirmed."
              }
            },
            "required": [
              "authors",
              "journal",
              "year",
              "publicationDate",
              "pmid",
              "doi",
              "url",
              "pubmedConfirmed"
            ],
            "additionalProperties": false,
            "description": "The bibliographic citation of the record."
          },
          "primaryType": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "human_research",
                  "in_vitro",
                  "in_vivo_preclinical",
                  "systematic_review",
                  "meta_analysis",
                  "narrative_review",
                  "scoping_review",
                  "ex_vivo",
                  "computational_in_silico",
                  "analytical_chemistry",
                  "mixed_or_translational",
                  "other_explicit"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "The research setting type, or null when it was never established."
          },
          "primaryTypeLabel": {
            "type": "string"
          },
          "publicGroup": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "human_research",
                  "in_vitro",
                  "in_vivo_preclinical",
                  "review_meta",
                  "other"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "The public group of the type, or null when the type was never established. Null is not the group other."
          },
          "verificationStatus": {
            "type": "string",
            "enum": [
              "evidence_verified",
              "citation_verified",
              "identifier_confirmed",
              "citation_only"
            ],
            "description": "How far the platform checked the record. Never an evidence-strength rating."
          },
          "verificationLabel": {
            "type": "string",
            "enum": [
              "Evidence verified by machine against declared source",
              "Evidence verified by human review against declared source",
              "Citation verified",
              "PMID confirmed at PubMed",
              "DOI confirmed at Crossref",
              "Citation only",
              "Under review",
              "Corrected",
              "Superseded",
              "Retracted"
            ]
          },
          "verificationKind": {
            "type": "string",
            "enum": [
              "machine_verified",
              "human_reviewed",
              "citation_verified",
              "identifier_confirmed",
              "corrected",
              "retracted",
              "unresolved"
            ]
          },
          "verificationEvidence": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "machine_verified",
                      "human_reviewed",
                      "citation_verified",
                      "identifier_confirmed",
                      "corrected",
                      "retracted",
                      "unresolved"
                    ]
                  },
                  "sourceUrl": {
                    "type": "string"
                  },
                  "sourceVersion": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "sourceCaptureHash": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "sourceRetrievedAt": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "summaryVersion": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": -9007199254740991,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "summaryHash": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "supportingReferences": {
                    "description": "The stored supporting references, as recorded."
                  },
                  "automatedChecks": {
                    "description": "The stored automated check results, as recorded."
                  },
                  "verificationMethod": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "verifiedAt": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "correctionState": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "evidenceDigest": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "status",
                  "sourceUrl",
                  "sourceVersion",
                  "sourceCaptureHash",
                  "sourceRetrievedAt",
                  "summaryVersion",
                  "summaryHash",
                  "supportingReferences",
                  "automatedChecks",
                  "verificationMethod",
                  "verifiedAt",
                  "correctionState",
                  "evidenceDigest"
                ],
                "additionalProperties": false,
                "description": "The receipt behind the verification of the record, as stored."
              },
              {
                "type": "null"
              }
            ]
          },
          "fullTextAvailability": {
            "type": "string",
            "enum": [
              "public_full_text",
              "licensed_private_full_text",
              "abstract_only",
              "citation_only",
              "unknown",
              "not_applicable"
            ]
          },
          "sourceScope": {
            "anyOf": [
              {
                "type": "string",
                "const": "abstract_only"
              },
              {
                "type": "null"
              }
            ]
          },
          "scale": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "reported",
                  "not_reported",
                  "not_applicable"
                ]
              },
              "text": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "status",
              "text"
            ],
            "additionalProperties": false,
            "description": "One summary field and whether the source reported it."
          },
          "limitations": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string",
                "enum": [
                  "reported",
                  "not_reported",
                  "not_applicable"
                ]
              },
              "text": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "status",
              "text"
            ],
            "additionalProperties": false,
            "description": "One summary field and whether the source reported it."
          },
          "relationships": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "product": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "exclusiveMinimum": 0,
                      "maximum": 9007199254740991
                    },
                    "slug": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "slug",
                    "name"
                  ],
                  "additionalProperties": false,
                  "description": "The catalog item the record is linked to."
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "direct_product",
                    "exact_entity",
                    "composition_component",
                    "close_analogue",
                    "mechanistic_context",
                    "catalog_source_association",
                    "not_applicable"
                  ]
                },
                "label": {
                  "type": "string"
                },
                "relevance": {
                  "type": "string",
                  "description": "The platform statement of what the link is. Never an effect or outcome claim."
                },
                "limitations": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "product",
                "type",
                "label",
                "relevance",
                "limitations"
              ],
              "additionalProperties": false,
              "description": "One link between the record and a catalog item."
            }
          },
          "summary": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "sections": {
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "string",
                          "enum": [
                            "reported",
                            "not_reported",
                            "not_applicable"
                          ]
                        },
                        "text": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "required": [
                        "status",
                        "text"
                      ],
                      "additionalProperties": false,
                      "description": "One summary field and whether the source reported it."
                    }
                  }
                },
                "required": [
                  "sections"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          },
          "summaryWithheldSections": {
            "description": "Summary fields the public boundary withheld because the stored draft failed the summary predicate.",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "withheldFields": {
            "description": "Field paths whose stored content the source rights do not admit for public serving, in rights-policy order.",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reviewedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "designSubtype": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "randomized_trial",
                  "nonrandomized_interventional_trial",
                  "cohort",
                  "case_control",
                  "cross_sectional",
                  "case_series",
                  "case_report",
                  "registry_analysis",
                  "qualitative_human_research",
                  "animal_controlled_experiment",
                  "animal_observational_study",
                  "cell_culture_experiment",
                  "isolated_biomolecule_assay",
                  "ex_vivo_tissue_experiment",
                  "systematic_review",
                  "meta_analysis",
                  "scoping_review",
                  "narrative_review",
                  "computational_model",
                  "analytical_method_study",
                  "mixed_design",
                  "other_explicit",
                  "not_reported",
                  "not_applicable"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "designSubtypeLabel": {
            "type": "string"
          },
          "publicState": {
            "type": "string",
            "enum": [
              "evidence_verified",
              "citation_verified",
              "identifier_confirmed",
              "citation_only",
              "under_review",
              "corrected",
              "superseded",
              "retracted",
              "suppressed"
            ],
            "description": "The state the state filter reads. A terminal state takes precedence over the rung."
          },
          "sourceLanguage": {
            "type": "string",
            "description": "The source language tag, or und when unknown."
          },
          "titleLanguage": {
            "type": "string",
            "description": "The title language tag, or und when unknown."
          },
          "datePrecision": {
            "type": "string",
            "enum": [
              "day",
              "month",
              "year",
              "unknown"
            ]
          },
          "correction": {
            "type": "object",
            "properties": {
              "state": {
                "type": "string",
                "enum": [
                  "current",
                  "corrected",
                  "expression_of_concern",
                  "retracted",
                  "unknown"
                ]
              },
              "successorPublicId": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "required": [
              "state",
              "successorPublicId"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "publicId",
          "title",
          "citation",
          "primaryType",
          "primaryTypeLabel",
          "publicGroup",
          "verificationStatus",
          "verificationLabel",
          "verificationKind",
          "verificationEvidence",
          "fullTextAvailability",
          "sourceScope",
          "scale",
          "limitations",
          "relationships",
          "summary",
          "reviewedAt",
          "designSubtype",
          "designSubtypeLabel",
          "publicState",
          "sourceLanguage",
          "titleLanguage",
          "datePrecision",
          "correction"
        ],
        "additionalProperties": false,
        "description": "One published research record linked to the catalog."
      }
    },
    "pageSize": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "nextCursor": {
      "description": "The signed cursor of the next page, or null on the last page.",
      "type": [
        "string",
        "null"
      ]
    },
    "counts": {
      "type": "object",
      "properties": {
        "total": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Every record in the filtered population."
        },
        "verifiedTotal": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "evidenceVerified plus citationVerified."
        },
        "evidenceVerified": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "citationVerified": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "identifierConfirmed": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "citationOnly": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "review": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "quarantined": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "byGroup": {
          "type": "object",
          "propertyNames": {
            "type": "string",
            "enum": [
              "human_research",
              "in_vitro",
              "in_vivo_preclinical",
              "review_meta",
              "other"
            ]
          },
          "additionalProperties": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "required": [
            "human_research",
            "in_vitro",
            "in_vivo_preclinical",
            "review_meta",
            "other"
          ],
          "description": "Verified records per group."
        },
        "archiveByGroup": {
          "type": "object",
          "propertyNames": {
            "type": "string",
            "enum": [
              "human_research",
              "in_vitro",
              "in_vivo_preclinical",
              "review_meta",
              "other"
            ]
          },
          "additionalProperties": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "required": [
            "human_research",
            "in_vitro",
            "in_vivo_preclinical",
            "review_meta",
            "other"
          ],
          "description": "All published records per group."
        },
        "archiveUnclassified": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "Published records in no group because their type was never established. Never folded into other."
        },
        "unclassified": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991,
          "description": "The same residual over the verified partition."
        }
      },
      "required": [
        "total",
        "verifiedTotal",
        "evidenceVerified",
        "citationVerified",
        "identifierConfirmed",
        "citationOnly",
        "byGroup",
        "archiveByGroup",
        "archiveUnclassified",
        "unclassified"
      ],
      "additionalProperties": false,
      "description": "Counts over the filtered population. total equals verifiedTotal plus identifierConfirmed plus citationOnly."
    },
    "facets": {
      "type": "object",
      "properties": {
        "types": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "human_research",
              "in_vitro",
              "in_vivo_preclinical",
              "systematic_review",
              "meta_analysis",
              "narrative_review",
              "scoping_review",
              "ex_vivo",
              "computational_in_silico",
              "analytical_chemistry",
              "mixed_or_translational",
              "other_explicit"
            ]
          }
        },
        "subtypes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "randomized_trial",
              "nonrandomized_interventional_trial",
              "cohort",
              "case_control",
              "cross_sectional",
              "case_series",
              "case_report",
              "registry_analysis",
              "qualitative_human_research",
              "animal_controlled_experiment",
              "animal_observational_study",
              "cell_culture_experiment",
              "isolated_biomolecule_assay",
              "ex_vivo_tissue_experiment",
              "systematic_review",
              "meta_analysis",
              "scoping_review",
              "narrative_review",
              "computational_model",
              "analytical_method_study",
              "mixed_design",
              "other_explicit",
              "not_reported",
              "not_applicable"
            ]
          }
        },
        "groups": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "human_research",
              "in_vitro",
              "in_vivo_preclinical",
              "review_meta",
              "other"
            ]
          }
        },
        "relationships": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "direct_product",
              "exact_entity",
              "composition_component",
              "close_analogue",
              "mechanistic_context",
              "catalog_source_association",
              "not_applicable"
            ]
          }
        },
        "sources": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "entities": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "exclusiveMinimum": 0,
                "maximum": 9007199254740991
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "slug",
              "name"
            ],
            "additionalProperties": false
          }
        },
        "years": {
          "type": "object",
          "properties": {
            "min": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "max": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "min",
            "max"
          ],
          "additionalProperties": false
        },
        "states": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "evidence_verified",
              "citation_verified",
              "identifier_confirmed",
              "citation_only"
            ]
          }
        },
        "fullText": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "public_full_text",
              "licensed_private_full_text",
              "abstract_only",
              "citation_only",
              "unknown",
              "not_applicable"
            ]
          }
        },
        "counts": {
          "type": "object",
          "properties": {
            "groups": {
              "type": "object",
              "propertyNames": {
                "type": "string",
                "enum": [
                  "human_research",
                  "in_vitro",
                  "in_vivo_preclinical",
                  "review_meta",
                  "other"
                ]
              },
              "additionalProperties": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "required": [
                "human_research",
                "in_vitro",
                "in_vivo_preclinical",
                "review_meta",
                "other"
              ]
            },
            "states": {
              "type": "object",
              "propertyNames": {
                "type": "string",
                "enum": [
                  "evidence_verified",
                  "citation_verified",
                  "identifier_confirmed",
                  "citation_only"
                ]
              },
              "additionalProperties": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              "required": [
                "evidence_verified",
                "citation_verified",
                "identifier_confirmed",
                "citation_only"
              ]
            },
            "fullText": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "types": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "relationships": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            }
          },
          "required": [
            "groups",
            "states",
            "fullText",
            "types",
            "relationships"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "types",
        "subtypes",
        "groups",
        "relationships",
        "sources",
        "entities",
        "years"
      ],
      "additionalProperties": false,
      "description": "The filter values this population can answer for. A value absent here returns no record."
    },
    "product": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "slug": {
              "type": "string"
            },
            "name": {
              "type": "string",
              "description": "The chemical sequence name."
            },
            "evidenceDisposition": {
              "type": "string",
              "enum": [
                "verified_studies_present",
                "no_verified_studies_yet",
                "reviewed_not_evaluable"
              ]
            },
            "researchSubjects": {
              "description": "What this archive’s records were indexed as examining: the record read’s subject index, every count read against archiveTotal. Null when the archive yields no admitted heading.",
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "indexedRecords": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "subjectRecords": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "withheldSubjects": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "subjectTotal": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "authority": {
                      "type": "object",
                      "properties": {
                        "provider": {
                          "type": "string"
                        },
                        "retrievedAt": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "provider",
                        "retrievedAt"
                      ],
                      "additionalProperties": false
                    },
                    "categories": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "enum": [
                              "disease_condition",
                              "biological_process",
                              "behavior_mental"
                            ]
                          },
                          "subjects": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "records": {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                }
                              },
                              "required": [
                                "name",
                                "records"
                              ],
                              "additionalProperties": false
                            }
                          }
                        },
                        "required": [
                          "id",
                          "subjects"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "indexedRecords",
                    "subjectRecords",
                    "withheldSubjects",
                    "subjectTotal",
                    "authority",
                    "categories"
                  ],
                  "additionalProperties": false,
                  "description": "Headings the archive records were indexed under, counted, never rewritten"
                },
                {
                  "type": "null"
                }
              ]
            },
            "archiveTotal": {
              "description": "The archive total every subject count is read against: the record read’s archiveTotal, which is verifiedTotal + identifierConfirmed + citationOnlyCount, never this page’s filtered counts.",
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991
            }
          },
          "required": [
            "id",
            "slug",
            "name",
            "evidenceDisposition"
          ],
          "additionalProperties": false,
          "description": "The catalog item a product-scoped page is about."
        },
        {
          "type": "null"
        }
      ]
    },
    "researchUseOnly": {
      "type": "string",
      "description": "The boundary statement that the public sender adds, stated once at the top level."
    }
  },
  "required": [
    "schemaVersion",
    "projectionRevision",
    "items",
    "pageSize",
    "nextCursor",
    "counts",
    "facets",
    "product",
    "researchUseOnly"
  ],
  "additionalProperties": false
}