DisclosureDetail

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0si-ai/json-schema/0si-ai-disclosure-detail-schema.json",
  "title": "DisclosureDetail",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0si-ai-openapi.json#/components/schemas/DisclosureDetail",
  "type": "object",
  "required": [
    "object",
    "data",
    "meta"
  ],
  "properties": {
    "object": {
      "const": "disclosure"
    },
    "data": {
      "allOf": [
        {
          "$ref": "#/$defs/Disclosure"
        },
        {
          "type": "object",
          "properties": {
            "document": {
              "type": "object",
              "properties": {
                "text": {
                  "type": "string"
                },
                "character_count": {
                  "type": "integer"
                }
              }
            },
            "asset_snapshot": {
              "$ref": "#/$defs/AssetSnapshot"
            },
            "disclosure_scale": {
              "$ref": "#/$defs/DisclosureScale"
            }
          }
        }
      ]
    },
    "meta": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "$defs": {
    "Amount": {
      "type": "object",
      "required": [
        "value",
        "display"
      ],
      "properties": {
        "value": {
          "type": [
            "number",
            "null"
          ]
        },
        "display": {
          "type": "string"
        }
      }
    },
    "Analysis": {
      "type": "object",
      "required": [
        "status",
        "signal",
        "signal_label",
        "confidence",
        "summary",
        "key_points",
        "risk_flags",
        "tags"
      ],
      "properties": {
        "status": {
          "type": "string",
          "description": "Current status in REST responses. In SSE and webhook event payloads, this is the immutable status at event time and matches event.analysis_status_at_event."
        },
        "signal": {
          "$ref": "#/$defs/Sentiment"
        },
        "signal_label": {
          "type": "string"
        },
        "confidence": {
          "type": "string",
          "enum": [
            "high",
            "medium",
            "low"
          ]
        },
        "summary": {
          "type": "string"
        },
        "key_points": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "risk_flags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "is_correction": {
          "type": "boolean"
        },
        "correction_materiality": {
          "type": "string"
        }
      }
    },
    "AssetSnapshot": {
      "type": "object",
      "properties": {
        "stock_code": {
          "type": "string"
        },
        "company_name": {
          "type": "string"
        },
        "market": {
          "type": "string"
        },
        "sector": {
          "type": "string"
        },
        "listing_status": {
          "type": "string"
        },
        "instrument_key": {
          "type": "string"
        },
        "country_code": {
          "type": "string",
          "enum": [
            "KR",
            "US"
          ]
        },
        "currency": {
          "type": "string"
        },
        "exchange": {
          "type": "string"
        },
        "cik": {
          "type": "string"
        },
        "metrics": {
          "type": "object",
          "additionalProperties": true
        },
        "shares": {
          "type": "object",
          "additionalProperties": true
        },
        "financials": {
          "type": "object",
          "additionalProperties": true
        },
        "quote": {
          "type": "object",
          "additionalProperties": true
        },
        "basis": {
          "type": "object",
          "additionalProperties": true
        },
        "pending_actions": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "additionalProperties": true
    },
    "CorporateActionDelta": {
      "type": "object",
      "required": [
        "schema_version",
        "type",
        "action_type",
        "status",
        "confidence"
      ],
      "properties": {
        "schema_version": {
          "const": 1
        },
        "type": {
          "const": "corporate_action_delta"
        },
        "action_type": {
          "type": "string",
          "enum": [
            "contract",
            "dividend",
            "buyback",
            "retirement",
            "capital_raise",
            "convertible",
            "share_split",
            "capital_reduction",
            "other"
          ]
        },
        "status": {
          "type": "string"
        },
        "amount_krw": {
          "type": [
            "number",
            "null"
          ]
        },
        "share_count": {
          "type": [
            "number",
            "null"
          ]
        },
        "issued_share_delta": {
          "type": [
            "number",
            "null"
          ]
        },
        "maximum_dilution_shares": {
          "type": [
            "number",
            "null"
          ]
        },
        "price_per_share": {
          "type": [
            "number",
            "null"
          ]
        },
        "ratio_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "confidence": {
          "type": "string",
          "enum": [
            "high",
            "medium",
            "low"
          ]
        },
        "details": {
          "type": "object",
          "additionalProperties": true
        }
      }
    },
    "CorrectionDelta": {
      "type": "object",
      "required": [
        "schema_version",
        "type",
        "changes"
      ],
      "properties": {
        "schema_version": {
          "const": 1
        },
        "type": {
          "const": "correction_delta"
        },
        "materiality": {
          "type": "string"
        },
        "changes": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "corporate_action": {
          "$ref": "#/$defs/CorporateActionDelta"
        }
      },
      "additionalProperties": true
    },
    "DeveloperEvent": {
      "type": "object",
      "required": [
        "id",
        "type",
        "reason",
        "occurred_at",
        "analysis_status_at_event"
      ],
      "properties": {
        "id": {
          "type": "integer"
        },
        "type": {
          "type": "string",
          "enum": [
            "disclosure.created",
            "disclosure.updated"
          ]
        },
        "reason": {
          "type": "string"
        },
        "occurred_at": {
          "type": "string",
          "format": "date-time"
        },
        "analysis_status_at_event": {
          "type": "string",
          "description": "Immutable analysis status captured when this event was created. It always matches analysis.status in the same event payload."
        }
      }
    },
    "Disclosure": {
      "type": "object",
      "required": [
        "id",
        "sequence",
        "company_name",
        "jurisdiction",
        "title",
        "source",
        "analysis",
        "market_reaction"
      ],
      "properties": {
        "id": {
          "type": "string"
        },
        "sequence": {
          "type": "integer"
        },
        "stock_code": {
          "type": "string"
        },
        "company_name": {
          "type": "string"
        },
        "market": {
          "type": "string"
        },
        "jurisdiction": {
          "type": "string",
          "enum": [
            "KR",
            "US"
          ]
        },
        "sector": {
          "type": "string"
        },
        "title": {
          "type": "string"
        },
        "source": {
          "type": "string"
        },
        "source_label": {
          "type": "string"
        },
        "filing_form": {
          "type": "string",
          "description": "SEC form such as 8-K or 10-Q; empty for Korean disclosures."
        },
        "sec": {
          "oneOf": [
            {
              "$ref": "#/$defs/SecMetadata"
            },
            {
              "type": "null"
            }
          ],
          "description": "Present for SEC filings and omitted for Korean disclosures."
        },
        "source_url": {
          "type": "string",
          "format": "uri"
        },
        "submitted_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "detected_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "published_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "analysis": {
          "$ref": "#/$defs/Analysis"
        },
        "earnings_delta": {
          "$ref": "#/$defs/EarningsDelta"
        },
        "delta": {
          "$ref": "#/$defs/GenericDelta"
        },
        "market_reaction": {
          "type": "object",
          "additionalProperties": true
        },
        "event": {
          "$ref": "#/$defs/DeveloperEvent"
        }
      }
    },
    "DisclosureScale": {
      "type": "object",
      "properties": {
        "metrics": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "primary_metric": {
          "type": [
            "object",
            "null"
          ],
          "additionalProperties": true
        }
      },
      "additionalProperties": true
    },
    "EarningsComparison": {
      "type": "object",
      "required": [
        "rate_pct",
        "transition",
        "label",
        "direction",
        "prior",
        "period"
      ],
      "properties": {
        "rate_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "Percentage change. Null for transitions such as profit turnaround."
        },
        "transition": {
          "type": [
            "string",
            "null"
          ],
          "description": "흑자전환 or 적자전환 when a percentage is not meaningful."
        },
        "label": {
          "type": "string"
        },
        "direction": {
          "type": "string",
          "enum": [
            "up",
            "down",
            "flat"
          ]
        },
        "prior": {
          "$ref": "#/$defs/Amount"
        },
        "period": {
          "type": "string"
        }
      }
    },
    "EarningsCumulative": {
      "type": "object",
      "required": [
        "current",
        "yoy"
      ],
      "properties": {
        "current": {
          "$ref": "#/$defs/Amount"
        },
        "yoy": {
          "oneOf": [
            {
              "$ref": "#/$defs/EarningsComparison"
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "EarningsDelta": {
      "type": "object",
      "required": [
        "schema_version",
        "type",
        "period",
        "basis",
        "basis_label",
        "unit",
        "is_correction",
        "metrics",
        "source_note"
      ],
      "properties": {
        "schema_version": {
          "const": 1
        },
        "type": {
          "const": "earnings_delta"
        },
        "period_type": {
          "type": "string",
          "enum": [
            "month"
          ],
          "description": "Optional discriminator for monthly country/entity earnings."
        },
        "period": {
          "type": "string"
        },
        "basis": {
          "type": "string",
          "enum": [
            "consolidated",
            "separate",
            "unknown"
          ]
        },
        "basis_label": {
          "type": "string"
        },
        "unit": {
          "type": "string"
        },
        "is_correction": {
          "type": "boolean"
        },
        "metrics": {
          "type": "array",
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/EarningsMetric"
          }
        },
        "source_note": {
          "type": "string"
        }
      }
    },
    "EarningsMetric": {
      "type": "object",
      "required": [
        "key",
        "label",
        "current",
        "qoq",
        "yoy",
        "cumulative"
      ],
      "properties": {
        "key": {
          "type": "string",
          "pattern": "^(revenue|operating_income|net_income|parent_net_income|diluted_eps|country:[^:]+:(revenue|operating_income|net_income|parent_net_income))$"
        },
        "label": {
          "type": "string"
        },
        "scope": {
          "type": "string",
          "description": "Country/entity scope for monthly earnings, not consolidated totals."
        },
        "current": {
          "$ref": "#/$defs/Amount"
        },
        "qoq": {
          "oneOf": [
            {
              "$ref": "#/$defs/EarningsComparison"
            },
            {
              "type": "null"
            }
          ]
        },
        "mom": {
          "description": "Month-over-month comparison. Present for period_type=month; qoq is null in that case.",
          "oneOf": [
            {
              "$ref": "#/$defs/EarningsComparison"
            },
            {
              "type": "null"
            }
          ]
        },
        "yoy": {
          "oneOf": [
            {
              "$ref": "#/$defs/EarningsComparison"
            },
            {
              "type": "null"
            }
          ]
        },
        "cumulative": {
          "oneOf": [
            {
              "$ref": "#/$defs/EarningsCumulative"
            },
            {
              "type": "null"
            }
          ]
        }
      }
    },
    "GenericDelta": {
      "oneOf": [
        {
          "$ref": "#/$defs/EarningsDelta"
        },
        {
          "$ref": "#/$defs/PeriodicDelta"
        },
        {
          "$ref": "#/$defs/CorrectionDelta"
        },
        {
          "$ref": "#/$defs/CorporateActionDelta"
        }
      ]
    },
    "PeriodicDelta": {
      "type": "object",
      "required": [
        "schema_version",
        "type",
        "metrics"
      ],
      "properties": {
        "schema_version": {
          "const": 1
        },
        "type": {
          "const": "periodic_delta"
        },
        "label": {
          "type": "string"
        },
        "headline": {
          "type": "string"
        },
        "description": {
          "type": "string"
        },
        "metrics": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/PeriodicMetric"
          }
        },
        "metadata": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "source_note": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "PeriodicMetric": {
      "type": "object",
      "required": [
        "key",
        "label",
        "current",
        "prior",
        "change",
        "change_value",
        "direction",
        "period",
        "prior_period",
        "comparison_basis"
      ],
      "properties": {
        "key": {
          "type": "string",
          "enum": [
            "revenue",
            "operating_income",
            "net_income",
            "diluted_eps",
            "assets",
            "liabilities",
            "equity",
            "cash",
            "operating_cash_flow"
          ]
        },
        "label": {
          "type": "string"
        },
        "current": {
          "type": "string"
        },
        "prior": {
          "type": "string"
        },
        "change": {
          "type": "string"
        },
        "change_value": {
          "type": [
            "number",
            "null"
          ]
        },
        "direction": {
          "type": "string",
          "enum": [
            "up",
            "down",
            "flat"
          ]
        },
        "period": {
          "type": "string"
        },
        "prior_period": {
          "type": "string"
        },
        "comparison_basis": {
          "type": "string"
        },
        "comparisons": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "ttm": {
          "type": "string"
        }
      }
    },
    "SecForm": {
      "type": "string",
      "pattern": "^[A-Z0-9][A-Z0-9 .-]{0,30}(/A)?$"
    },
    "SecMetadata": {
      "type": "object",
      "required": [
        "accession_number",
        "cik",
        "form",
        "base_form",
        "is_amendment",
        "is_periodic",
        "report_period",
        "fiscal_year"
      ],
      "properties": {
        "accession_number": {
          "type": "string",
          "pattern": "^[0-9]{10}-[0-9]{2}-[0-9]{6}$"
        },
        "cik": {
          "type": "string",
          "pattern": "^$|^[0-9]{10}$"
        },
        "form": {
          "$ref": "#/$defs/SecForm"
        },
        "base_form": {
          "$ref": "#/$defs/SecForm"
        },
        "is_amendment": {
          "type": "boolean"
        },
        "is_periodic": {
          "type": "boolean"
        },
        "report_period": {
          "type": "string",
          "description": "XBRL reporting period when available."
        },
        "fiscal_year": {
          "type": "string"
        }
      }
    },
    "Sentiment": {
      "type": "string",
      "enum": [
        "very_positive",
        "positive",
        "neutral",
        "negative",
        "very_negative"
      ]
    }
  }
}