{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/v3.CompanyEventList",
  "title": "v3.CompanyEventList",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/roic-ai-openapi.json#/components/schemas/v3.CompanyEventList",
  "additionalProperties": false,
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "additionalProperties": false,
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "symbol": {
            "type": "string"
          },
          "fiscal_year": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "format": "integer",
                    "default": 0,
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "fiscal_quarter": {
            "anyOf": [
              {
                "anyOf": [
                  {
                    "format": "integer",
                    "default": 0,
                    "type": "string"
                  },
                  {
                    "type": "integer"
                  }
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "period_end_date": {
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "minLength": 10,
            "maxLength": 10,
            "description": "A calendar date in YYYY-MM-DD format.",
            "type": "string"
          },
          "release_date": {
            "anyOf": [
              {
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                "minLength": 10,
                "maxLength": 10,
                "description": "A calendar date in YYYY-MM-DD format.",
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "description": "When this resource was first stored.",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "description": "When this resource last changed.",
            "type": "string"
          },
          "transcripts": {
            "type": "array",
            "items": {
              "additionalProperties": false,
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "type": {
                  "type": "string",
                  "enum": [
                    "raw",
                    "edited"
                  ]
                },
                "language": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "created_at": {
                  "format": "date-time",
                  "description": "When this resource was first stored.",
                  "type": "string"
                },
                "updated_at": {
                  "format": "date-time",
                  "description": "When this resource last changed.",
                  "type": "string"
                }
              },
              "required": [
                "id",
                "type",
                "language",
                "created_at",
                "updated_at"
              ],
              "$id": "#/components/schemas/v3.CompanyEventTranscript"
            }
          },
          "audio": {
            "type": "array",
            "items": {
              "additionalProperties": false,
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "filename": {
                  "description": "The download name, `{EXCHANGE}-{SYMBOL}_{kind}[-{form}]_{period_end_date}[_{FY-label}][_{lang}]_{id}.{ext}`. The fiscal label (`FY2026-Q3`, `FY2026-H1`, `FY2026` for annual reports) appears only when the period is certain; the language only when not English. The signed download sends the same name in Content-Disposition.",
                  "type": "string"
                },
                "document_group": {
                  "description": "Always `audio`: the recording is not one of the document groups.",
                  "const": "audio",
                  "type": "string"
                },
                "document_kind": {
                  "description": "Always `earnings_call`: the recording is the call itself.",
                  "const": "earnings_call",
                  "type": "string"
                },
                "language": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "id",
                "filename",
                "document_group",
                "document_kind",
                "language"
              ],
              "$id": "#/components/schemas/v3.CompanyEventAudio"
            }
          },
          "slides": {
            "type": "array",
            "items": {
              "additionalProperties": false,
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "filename": {
                  "description": "The download name, `{EXCHANGE}-{SYMBOL}_{kind}[-{form}]_{period_end_date}[_{FY-label}][_{lang}]_{id}.{ext}`. The fiscal label (`FY2026-Q3`, `FY2026-H1`, `FY2026` for annual reports) appears only when the period is certain; the language only when not English. The signed download sends the same name in Content-Disposition.",
                  "type": "string"
                },
                "document_group": {
                  "type": "string",
                  "enum": [
                    "earnings",
                    "financial_report",
                    "presentation",
                    "regulatory",
                    "sustainability",
                    "transcript",
                    "other"
                  ]
                },
                "document_kind": {
                  "type": "string",
                  "enum": [
                    "earnings_release",
                    "shareholder_letter",
                    "prepared_remarks",
                    "annual_report",
                    "quarterly_report",
                    "interim_report",
                    "financial_statements",
                    "management_discussion_analysis",
                    "annual_information_form",
                    "presentation",
                    "proxy_statement",
                    "registration_statement",
                    "pillar_3_report",
                    "sustainability_report",
                    "governance_report",
                    "press_release",
                    "fact_book",
                    "transcript",
                    "other"
                  ]
                },
                "language": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "id",
                "filename",
                "document_group",
                "document_kind",
                "language"
              ],
              "$id": "#/components/schemas/v3.CompanyEventSlides"
            }
          },
          "filings": {
            "type": "array",
            "items": {
              "additionalProperties": false,
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "filename": {
                  "description": "The download name, `{EXCHANGE}-{SYMBOL}_{kind}[-{form}]_{period_end_date}[_{FY-label}][_{lang}]_{id}.{ext}`. The fiscal label (`FY2026-Q3`, `FY2026-H1`, `FY2026` for annual reports) appears only when the period is certain; the language only when not English. The signed download sends the same name in Content-Disposition.",
                  "type": "string"
                },
                "form": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "document_group": {
                  "type": "string",
                  "enum": [
                    "earnings",
                    "financial_report",
                    "presentation",
                    "regulatory",
                    "sustainability",
                    "transcript",
                    "other"
                  ]
                },
                "document_kind": {
                  "type": "string",
                  "enum": [
                    "earnings_release",
                    "shareholder_letter",
                    "prepared_remarks",
                    "annual_report",
                    "quarterly_report",
                    "interim_report",
                    "financial_statements",
                    "management_discussion_analysis",
                    "annual_information_form",
                    "presentation",
                    "proxy_statement",
                    "registration_statement",
                    "pillar_3_report",
                    "sustainability_report",
                    "governance_report",
                    "press_release",
                    "fact_book",
                    "transcript",
                    "other"
                  ]
                },
                "language": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "id",
                "filename",
                "form",
                "document_group",
                "document_kind",
                "language"
              ],
              "$id": "#/components/schemas/v3.CompanyEventFiling"
            }
          }
        },
        "required": [
          "id",
          "symbol",
          "fiscal_year",
          "fiscal_quarter",
          "period_end_date",
          "release_date",
          "created_at",
          "updated_at",
          "transcripts",
          "audio",
          "slides",
          "filings"
        ],
        "$id": "#/components/schemas/v3.CompanyEvent"
      }
    },
    "next_page_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "previous_page_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "data",
    "next_page_url",
    "previous_page_url"
  ]
}