Study

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/system/main/json-schema/system-study-schema.json",
  "title": "Study",
  "description": "Study.",
  "x-generated": "2026-10-24",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/system-api-openapi.json#/components/schemas/Study",
  "properties": {
    "id": {
      "type": "string",
      "title": "Id",
      "description": "Unique identifier",
      "filterable": true
    },
    "doi": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Doi",
      "description": "Digital Object Identifier (DOI)",
      "filterable": true
    },
    "pmid": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pmid",
      "description": "PubMed Identifier (PMID)",
      "filterable": true
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Title",
      "description": "Title of the study"
    },
    "authors": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/Author"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Authors",
      "description": "Authors of the study"
    },
    "journal": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Journal",
      "description": "Journal the study was published in"
    },
    "publish_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date"
        },
        {
          "type": "null"
        }
      ],
      "title": "Publish Date",
      "description": "Year of publication",
      "filterable": true,
      "sortable": true
    },
    "population": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Population",
      "description": "Population studied"
    },
    "sample_size": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sample Size",
      "description": "Sample size of the study",
      "sortable": true
    },
    "summary": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Summary",
      "description": "Summary of the study"
    },
    "cited_by": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cited By",
      "description": "Number of times study was cited by another study",
      "filterable": true,
      "sortable": true
    },
    "study_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Study Type",
      "description": "Type of study",
      "filterable": true
    },
    "retraction_reason": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Retraction Reason",
      "description": "Reason for retraction of study"
    }
  },
  "type": "object",
  "required": [
    "id"
  ],
  "$defs": {
    "Author": {
      "properties": {
        "full_name": {
          "type": "string",
          "title": "Full Name",
          "description": "Full name of author"
        },
        "orcid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Orcid",
          "description": "ORCID of author"
        },
        "openalex_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Openalex Id",
          "description": "OpenAlex ID of author"
        }
      },
      "type": "object",
      "required": [
        "full_name"
      ],
      "title": "Author",
      "description": "Author."
    }
  }
}