Skip to content

filing.index · v1 · financial

SEC filing index

Available

One operating issuer’s recent SEC filings by exact CIK from the official EDGAR submissions index: form type, filing date, report date, accession number, size and the primary-document and filing-index links. Optional form-type and filing-date filters, at most 100 filings per call, newest first. It lists filings; it does not return filing text.

Input schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": [
    "cik"
  ],
  "additionalProperties": false,
  "properties": {
    "cik": {
      "type": "string",
      "pattern": "^[0-9]{10}$",
      "description": "Exact ten-digit nonzero SEC CIK."
    },
    "forms": {
      "type": "string",
      "minLength": 1,
      "maxLength": 250,
      "description": "Comma-separated exact SEC form types, at most 10 (for example 10-K,8-K). An amendment such as 10-K/A is a separate form type."
    },
    "filedFrom": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "Inclusive earliest filing date, YYYY-MM-DD."
    },
    "filedTo": {
      "type": "string",
      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
      "description": "Inclusive latest filing date, YYYY-MM-DD."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Most filings returned, newest first. Default and maximum 100."
    }
  }
}
Output schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "number",
      "const": 1
    },
    "kind": {
      "type": "string",
      "const": "PUBLIC_FILING_INDEX"
    },
    "coverage": {
      "type": "string",
      "const": "SEC_SUBMISSIONS_RECENT_FILINGS"
    },
    "issuer": {
      "type": "object",
      "properties": {
        "cik": {
          "type": "string",
          "pattern": "^\\d{10}$"
        },
        "reportedName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        }
      },
      "required": [
        "cik",
        "reportedName"
      ],
      "additionalProperties": false
    },
    "request": {
      "type": "object",
      "properties": {
        "forms": {
          "anyOf": [
            {
              "maxItems": 10,
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ]
        },
        "filedFrom": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "filedTo": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "limit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 100
        }
      },
      "required": [
        "forms",
        "filedFrom",
        "filedTo",
        "limit"
      ],
      "additionalProperties": false
    },
    "filings": {
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "accessionNumber": {
            "type": "string",
            "pattern": "^\\d{10}-\\d{2}-\\d{6}$"
          },
          "form": {
            "type": "string",
            "pattern": "^[A-Za-z0-9][A-Za-z0-9 /-]{0,39}$"
          },
          "filingDate": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "reportDate": {
            "anyOf": [
              {
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
              },
              {
                "type": "null"
              }
            ]
          },
          "sizeBytes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "primaryDocument": {
            "type": [
              "string",
              "null"
            ]
          },
          "primaryDocumentUrl": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 400
              },
              {
                "type": "null"
              }
            ]
          },
          "filingIndexUrl": {
            "type": "string",
            "maxLength": 400
          }
        },
        "required": [
          "accessionNumber",
          "form",
          "filingDate",
          "reportDate",
          "sizeBytes",
          "primaryDocument",
          "primaryDocumentUrl",
          "filingIndexUrl"
        ],
        "additionalProperties": false
      }
    },
    "summary": {
      "type": "object",
      "properties": {
        "matched": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "returned": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "truncated": {
          "type": "boolean"
        },
        "recentRowsRead": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "newestRecentFilingDate": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "oldestRecentFilingDate": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "olderArchivePages": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "complete": {
          "type": "boolean"
        }
      },
      "required": [
        "matched",
        "returned",
        "truncated",
        "recentRowsRead",
        "newestRecentFilingDate",
        "oldestRecentFilingDate",
        "olderArchivePages",
        "complete"
      ],
      "additionalProperties": false
    },
    "source": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string"
        },
        "fetchedAt": {
          "type": "string",
          "format": "date-time",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
        },
        "responseSha256": {
          "type": "string",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "required": [
        "url",
        "fetchedAt",
        "responseSha256"
      ],
      "additionalProperties": false
    },
    "unknowns": {
      "maxItems": 2,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "const": "filings"
          },
          "reason": {
            "type": "string",
            "enum": [
              "older_filing_pages_not_read",
              "invalid_source_value"
            ]
          }
        },
        "required": [
          "field",
          "reason"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "schemaVersion",
    "kind",
    "coverage",
    "issuer",
    "request",
    "filings",
    "summary",
    "source",
    "unknowns"
  ],
  "additionalProperties": false
}