{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/earningsfeed-com/json-schema/earningsfeed-com-filings-feed-response-schema.json",
  "title": "FilingsFeedResponse",
  "x-generated": "2026-11-06",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/earningsfeed-com-openapi.json#/components/schemas/FilingsFeedResponse",
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/FeedFiling"
      }
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cursor for next page, null if no more pages"
    },
    "hasMore": {
      "type": "boolean",
      "description": "Whether more items exist beyond this page"
    },
    "appliedFilters": {
      "$ref": "#/$defs/AppliedFilters"
    }
  },
  "required": [
    "items",
    "nextCursor",
    "hasMore",
    "appliedFilters"
  ],
  "$defs": {
    "AppliedFilters": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "integer"
        },
        "forms": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "status": {
          "type": "string",
          "enum": [
            "all",
            "final",
            "provisional"
          ],
          "default": "all",
          "description": "Filter by filing status. 'final' excludes provisional filings, 'provisional' shows only provisional."
        },
        "cik": {
          "type": [
            "integer",
            "null"
          ]
        },
        "ticker": {
          "type": [
            "string",
            "null"
          ]
        },
        "q": {
          "type": [
            "string",
            "null"
          ]
        },
        "startDate": {
          "type": [
            "string",
            "null"
          ]
        },
        "endDate": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "limit",
        "forms",
        "cik",
        "ticker",
        "q",
        "startDate",
        "endDate"
      ]
    },
    "FeedFiling": {
      "type": "object",
      "properties": {
        "accessionNumber": {
          "type": "string",
          "pattern": "^(\\d{10}-\\d{2}-\\d{6}|\\d{18})$",
          "description": "SEC accession number (e.g., 0000320193-24-000126)"
        },
        "accessionNoDashes": {
          "type": [
            "string",
            "null"
          ],
          "description": "Accession number without dashes"
        },
        "cik": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "SEC Central Index Key (CIK) - unique company/filer identifier"
        },
        "companyName": {
          "type": [
            "string",
            "null"
          ],
          "description": "Company name from the filing"
        },
        "formType": {
          "type": "string",
          "description": "SEC form type"
        },
        "filedAt": {
          "type": "string",
          "format": "date-time",
          "description": "SEC filing date. A calendar date encoded as midnight UTC: read only the date part (YYYY-MM-DD) and never convert it to a local time zone. For the moment the SEC accepted the filing, use acceptTs."
        },
        "acceptTs": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time",
          "description": "When the SEC accepted the filing"
        },
        "provisional": {
          "type": "boolean",
          "description": "Whether this is a provisional (not yet finalized) filing"
        },
        "feedDay": {
          "type": [
            "string",
            "null"
          ],
          "description": "Feed day in YYYY-MM-DD format"
        },
        "sizeBytes": {
          "type": "integer",
          "description": "Size of the primary document in bytes"
        },
        "url": {
          "type": "string",
          "format": "uri",
          "description": "URL to the filing on SEC EDGAR"
        },
        "title": {
          "type": "string",
          "description": "Filing title/description"
        },
        "status": {
          "type": "string",
          "description": "Filing status (live, pending, etc.)"
        },
        "updatedAt": {
          "type": "string",
          "format": "date-time",
          "description": "When the filing record was last updated"
        },
        "primaryTicker": {
          "type": [
            "string",
            "null"
          ],
          "description": "Primary stock ticker symbol"
        },
        "primaryExchange": {
          "type": [
            "string",
            "null"
          ],
          "description": "Primary stock exchange"
        },
        "company": {
          "$ref": "#/$defs/FilingCompany"
        },
        "sortedAt": {
          "type": "string",
          "format": "date-time",
          "description": "Timestamp used for feed sorting"
        },
        "logoUrl": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri",
          "description": "URL to the company logo if available"
        },
        "entityClass": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "company",
            "person",
            null
          ],
          "description": "Classification of the filing entity. 'company' indicates an issuer, 'person' indicates an individual insider."
        },
        "issuer": {
          "$ref": "#/$defs/FilingIssuer"
        }
      },
      "required": [
        "accessionNumber",
        "accessionNoDashes",
        "cik",
        "companyName",
        "formType",
        "filedAt",
        "acceptTs",
        "provisional",
        "feedDay",
        "sizeBytes",
        "url",
        "title",
        "status",
        "updatedAt",
        "primaryTicker",
        "primaryExchange",
        "company",
        "sortedAt",
        "logoUrl",
        "entityClass",
        "issuer"
      ]
    },
    "FilingCompany": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "cik": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "SEC Central Index Key (CIK) - unique company/filer identifier"
        },
        "name": {
          "type": "string",
          "description": "Company name"
        },
        "stateOfIncorporation": {
          "type": [
            "string",
            "null"
          ],
          "description": "State or country of incorporation code"
        },
        "stateOfIncorporationDescription": {
          "type": [
            "string",
            "null"
          ],
          "description": "Full name of incorporation location"
        },
        "fiscalYearEnd": {
          "type": [
            "string",
            "null"
          ],
          "description": "Fiscal year end (MMDD format)"
        }
      },
      "required": [
        "cik",
        "name",
        "stateOfIncorporation",
        "stateOfIncorporationDescription",
        "fiscalYearEnd"
      ],
      "description": "Company details if available"
    },
    "FilingIssuer": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "cik": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "SEC Central Index Key (CIK) - unique company/filer identifier"
        },
        "name": {
          "type": "string",
          "description": "Issuer name as written on the form"
        },
        "ticker": {
          "type": [
            "string",
            "null"
          ],
          "description": "Issuer trading symbol on the form"
        }
      },
      "required": [
        "cik",
        "name",
        "ticker"
      ],
      "description": "For Forms 3, 4 and 5: the company whose securities the insider reports on. cik and companyName describe the reporting insider who filed. Null for other forms, and until the form's ownership data is parsed."
    }
  }
}