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
}