{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cubesphere-xyz/json-schema/cubesphere-xyz-timeline-response-schema.json",
  "title": "TimelineResponse",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cubesphere-xyz-openapi.yml#/components/schemas/TimelineResponse",
  "properties": {
    "ticker": {
      "type": "string",
      "title": "Ticker"
    },
    "issuer_cik": {
      "type": "string",
      "title": "Issuer Cik"
    },
    "items": {
      "items": {
        "$ref": "#/$defs/TimelineItem"
      },
      "type": "array",
      "title": "Items"
    },
    "limitations": {
      "additionalProperties": {
        "type": "string"
      },
      "type": "object",
      "title": "Limitations"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "ticker",
    "issuer_cik",
    "items",
    "limitations"
  ],
  "$defs": {
    "TimelineItem": {
      "properties": {
        "source_form": {
          "type": "string",
          "enum": [
            "form4",
            "sc13",
            "form144"
          ],
          "title": "Source Form"
        },
        "accession_no": {
          "type": "string",
          "title": "Accession No"
        },
        "known_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Known At"
        },
        "event_revision": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "title": "Event Revision"
        }
      },
      "additionalProperties": true,
      "type": "object",
      "required": [
        "source_form",
        "accession_no"
      ],
      "title": "TimelineItem",
      "description": "`GET /v1/companies/{ticker}/timeline` 행 1건 — Form4 · 13D/G · 144 통합.\n\n출처마다 그 다음 필드가 다르다(`extra=\"allow\"`) — 공통 계약은 `source_form`·\n`accession_no`·`known_at`·`event_revision` 뿐이다. **13D/G·144 는 revision\n개념이 없어 `event_revision` 이 항상 null** — 결측이 아니라 그 폼의 사실이다\n(`product/timeline.py` 참조)."
    }
  }
}