{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/helena-bio/json-schema/helena-bio-cytoband-response-schema.json",
  "title": "CytobandResponse",
  "description": "The cytoband band list for one chromosome (the IdeogramLane read surface).\n\nbands is sorted by start_pos and is the WHOLE-chromosome list (the client draws the\nbar from it and scans it for the SV-midpoint containing band -- no second route).\nAn unknown chrom or a pre-load reference_db yields bands: [] (degrade-clean), never\na 4xx/5xx.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/helena-bio-reference-api-openapi.yml#/components/schemas/CytobandResponse",
  "properties": {
    "chrom": {
      "type": "string",
      "title": "Chrom"
    },
    "coord_system": {
      "type": "string",
      "title": "Coord System",
      "default": "ucsc-0-based-half-open"
    },
    "bands": {
      "items": {
        "$ref": "#/$defs/CytobandBand"
      },
      "type": "array",
      "title": "Bands"
    }
  },
  "type": "object",
  "required": [
    "chrom",
    "bands"
  ],
  "$defs": {
    "CytobandBand": {
      "properties": {
        "start_pos": {
          "type": "integer",
          "title": "Start Pos"
        },
        "end_pos": {
          "type": "integer",
          "title": "End Pos"
        },
        "band_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Band Name"
        },
        "gie_stain": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gie Stain"
        },
        "arm": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Arm",
          "description": "Chromosome arm (p/q), the leading char of band_name; None when band_name is absent"
        }
      },
      "type": "object",
      "required": [
        "start_pos",
        "end_pos"
      ],
      "title": "CytobandBand",
      "description": "One cytogenetic band (UCSC cytoBandIdeo), AS PUBLISHED.\n\nCoordinates are 0-based half-open (see the response coord_system). arm is the\nNone-safe leading char of band_name (p/q), or None when band_name is absent --\nderived at the read surface as `band_name[:1] if band_name else None` (the SLICE\nform; band_name is NULLABLE, so the index form band_name[0] is FORBIDDEN, Eunomia\nB1). gie_stain is the Giemsa class VERBATIM; the stain->fill mapping is the\nfrontend's."
    }
  }
}