Variant

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/genialis/main/json-schema/genialis-variant-schema.json",
  "title": "Variant",
  "description": "Serializer for Variant objects.",
  "x-generated": "2026-10-20",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/genialis-variant-api-openapi.yml#/components/schemas/Variant",
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "readOnly": true
    },
    "species": {
      "type": "string",
      "maxLength": 50
    },
    "genome_assembly": {
      "type": "string",
      "maxLength": 20
    },
    "chromosome": {
      "type": "string",
      "maxLength": 20
    },
    "position": {
      "type": "integer",
      "maximum": 9223372036854775807,
      "minimum": 0,
      "format": "int64"
    },
    "reference": {
      "type": "string"
    },
    "alternative": {
      "type": "string"
    },
    "annotation": {
      "allOf": [
        {
          "$ref": "#/$defs/VariantAnnotation"
        }
      ]
    }
  },
  "required": [
    "alternative",
    "chromosome",
    "genome_assembly",
    "id",
    "position",
    "reference",
    "species"
  ],
  "$defs": {
    "BlankEnum": {
      "enum": [
        ""
      ]
    },
    "NullEnum": {
      "enum": [
        null
      ]
    },
    "VariantAnnotation": {
      "type": "object",
      "description": "Serializer for VariantAnnotation objects.",
      "properties": {
        "id": {
          "type": "integer",
          "readOnly": true
        },
        "variant_id": {
          "type": "integer",
          "readOnly": true
        },
        "type": {
          "oneOf": [
            {
              "$ref": "#/$defs/VariantAnnotationTypeEnum"
            },
            {
              "$ref": "#/$defs/BlankEnum"
            },
            {
              "$ref": "#/$defs/NullEnum"
            }
          ]
        },
        "clinical_diagnosis": {
          "type": [
            "string",
            "null"
          ]
        },
        "clinical_significance": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 100
        },
        "dbsnp_id": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 150
        },
        "clinvar_id": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 150
        },
        "transcripts": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/VariantTranscript"
          }
        }
      },
      "required": [
        "id",
        "variant_id"
      ]
    },
    "VariantAnnotationTypeEnum": {
      "enum": [
        "SNP",
        "INDEL",
        "MIXED",
        "MNP",
        "SYMBOLIC"
      ],
      "type": "string",
      "description": "* `SNP` - SNP\n* `INDEL` - INDEL\n* `MIXED` - MIXED\n* `MNP` - MNP\n* `SYMBOLIC` - SYMBOLIC"
    },
    "VariantTranscript": {
      "type": "object",
      "description": "Serializer for VariantAnnotationTranscript objects.",
      "properties": {
        "id": {
          "type": "integer",
          "readOnly": true
        },
        "variant_annotation_id": {
          "type": "integer",
          "readOnly": true
        },
        "annotation": {
          "type": "string"
        },
        "annotation_impact": {
          "type": "string",
          "maxLength": 20
        },
        "gene": {
          "type": "string",
          "maxLength": 100
        },
        "protein_impact": {
          "type": "string",
          "maxLength": 100
        },
        "transcript_id": {
          "type": "string",
          "maxLength": 200
        },
        "canonical": {
          "type": "boolean"
        }
      },
      "required": [
        "annotation",
        "annotation_impact",
        "gene",
        "id",
        "protein_impact",
        "transcript_id",
        "variant_annotation_id"
      ]
    }
  }
}