SEC EDGAR · Schema

SEC EDGAR Company Submissions

Schema for the SEC EDGAR company submissions endpoint response (data.sec.gov/submissions/CIK{cik}.json)

Financial DataSECEDGARPublic Company FilingsXBRLRegulatoryGovernmentFinancial ReportingCompany SubmissionsSecurities

Properties

Name Type Description
cik string Central Index Key as a string
entityType string SEC entity classification type
sic string Standard Industrial Classification code
sicDescription string Human-readable SIC description
ownerOrg string SEC division/office responsible for oversight
insiderTransactionForOwnerExists integer Whether insider transaction forms exist where entity is the owner
insiderTransactionForIssuerExists integer Whether insider transaction forms exist where entity is the issuer
name string Company legal name
tickers array Stock ticker symbols
exchanges array Stock exchanges listing the company
ein string Employer Identification Number
lei stringnull Legal Entity Identifier (ISO 17442)
description string Company description
website string Company website URL
investorWebsite string Investor relations website URL
category string SEC filer category
fiscalYearEnd string Fiscal year end in MMDD format
stateOfIncorporation string State or country of incorporation code
stateOfIncorporationDescription string State or country of incorporation description
addresses object Company addresses
phone string Company phone number
flags string Special flags associated with the company
formerNames array Previous legal names of the company
filings object Filing history container
View JSON Schema on GitHub

JSON Schema

sec-company-submissions.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/sec/main/json-schema/sec-company-submissions.json",
  "title": "SEC EDGAR Company Submissions",
  "description": "Schema for the SEC EDGAR company submissions endpoint response (data.sec.gov/submissions/CIK{cik}.json)",
  "type": "object",
  "required": ["cik", "name", "filings"],
  "properties": {
    "cik": {
      "type": "string",
      "description": "Central Index Key as a string",
      "pattern": "^\\d{10}$",
      "examples": ["0000320193"]
    },
    "entityType": {
      "type": "string",
      "description": "SEC entity classification type",
      "examples": ["operating"]
    },
    "sic": {
      "type": "string",
      "description": "Standard Industrial Classification code",
      "pattern": "^\\d{4}$",
      "examples": ["3571"]
    },
    "sicDescription": {
      "type": "string",
      "description": "Human-readable SIC description",
      "examples": ["Electronic Computers"]
    },
    "ownerOrg": {
      "type": "string",
      "description": "SEC division/office responsible for oversight",
      "examples": ["06 Technology"]
    },
    "insiderTransactionForOwnerExists": {
      "type": "integer",
      "enum": [0, 1],
      "description": "Whether insider transaction forms exist where entity is the owner"
    },
    "insiderTransactionForIssuerExists": {
      "type": "integer",
      "enum": [0, 1],
      "description": "Whether insider transaction forms exist where entity is the issuer"
    },
    "name": {
      "type": "string",
      "description": "Company legal name",
      "examples": ["Apple Inc."]
    },
    "tickers": {
      "type": "array",
      "description": "Stock ticker symbols",
      "items": {
        "type": "string"
      },
      "examples": [["AAPL"]]
    },
    "exchanges": {
      "type": "array",
      "description": "Stock exchanges listing the company",
      "items": {
        "type": "string"
      },
      "examples": [["Nasdaq"]]
    },
    "ein": {
      "type": "string",
      "description": "Employer Identification Number",
      "examples": ["942404110"]
    },
    "lei": {
      "type": ["string", "null"],
      "description": "Legal Entity Identifier (ISO 17442)",
      "examples": [null]
    },
    "description": {
      "type": "string",
      "description": "Company description"
    },
    "website": {
      "type": "string",
      "description": "Company website URL"
    },
    "investorWebsite": {
      "type": "string",
      "description": "Investor relations website URL"
    },
    "category": {
      "type": "string",
      "description": "SEC filer category",
      "examples": ["Large accelerated filer"]
    },
    "fiscalYearEnd": {
      "type": "string",
      "description": "Fiscal year end in MMDD format",
      "pattern": "^(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])$",
      "examples": ["0926"]
    },
    "stateOfIncorporation": {
      "type": "string",
      "description": "State or country of incorporation code",
      "examples": ["CA"]
    },
    "stateOfIncorporationDescription": {
      "type": "string",
      "description": "State or country of incorporation description",
      "examples": ["CA"]
    },
    "addresses": {
      "type": "object",
      "description": "Company addresses",
      "properties": {
        "mailing": {
          "$ref": "#/$defs/Address"
        },
        "business": {
          "$ref": "#/$defs/Address"
        }
      }
    },
    "phone": {
      "type": "string",
      "description": "Company phone number",
      "examples": ["(408) 996-1010"]
    },
    "flags": {
      "type": "string",
      "description": "Special flags associated with the company"
    },
    "formerNames": {
      "type": "array",
      "description": "Previous legal names of the company",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "from": {
            "type": "string",
            "format": "date-time"
          },
          "to": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "filings": {
      "type": "object",
      "description": "Filing history container",
      "required": ["recent"],
      "properties": {
        "recent": {
          "$ref": "#/$defs/FilingList"
        },
        "files": {
          "type": "array",
          "description": "References to paginated filing history files",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Filename for additional filing history JSON"
              },
              "filingCount": {
                "type": "integer",
                "description": "Number of filings in this file"
              },
              "filingFrom": {
                "type": "string",
                "format": "date",
                "description": "Earliest filing date in this file"
              },
              "filingTo": {
                "type": "string",
                "format": "date",
                "description": "Latest filing date in this file"
              }
            }
          }
        }
      }
    }
  },
  "$defs": {
    "Address": {
      "type": "object",
      "description": "Physical or mailing address",
      "properties": {
        "street1": {
          "type": "string"
        },
        "street2": {
          "type": ["string", "null"]
        },
        "city": {
          "type": "string"
        },
        "stateOrCountry": {
          "type": "string"
        },
        "zipCode": {
          "type": "string"
        },
        "stateOrCountryDescription": {
          "type": "string"
        },
        "isForeignLocation": {
          "type": ["integer", "null"]
        }
      }
    },
    "FilingList": {
      "type": "object",
      "description": "Parallel arrays of filing metadata indexed by position",
      "properties": {
        "accessionNumber": {
          "type": "array",
          "items": { "type": "string" },
          "description": "SEC accession numbers (XXXXXXXXXX-YY-ZZZZZZ)"
        },
        "filingDate": {
          "type": "array",
          "items": { "type": "string", "format": "date" },
          "description": "Filing acceptance dates"
        },
        "reportDate": {
          "type": "array",
          "items": { "type": "string", "format": "date" },
          "description": "Period of report end dates"
        },
        "acceptanceDateTime": {
          "type": "array",
          "items": { "type": "string" },
          "description": "EDGAR acceptance timestamps"
        },
        "act": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Securities act reference"
        },
        "form": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Form types (10-K, 10-Q, 8-K, etc.)"
        },
        "fileNumber": {
          "type": "array",
          "items": { "type": "string" },
          "description": "SEC file numbers"
        },
        "filmNumber": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Film numbers for Securities Act filings"
        },
        "items": {
          "type": "array",
          "items": { "type": "string" },
          "description": "8-K items disclosed"
        },
        "size": {
          "type": "array",
          "items": { "type": "integer" },
          "description": "Filing sizes in bytes"
        },
        "isXBRL": {
          "type": "array",
          "items": { "type": "integer", "enum": [0, 1] },
          "description": "XBRL inclusion flag"
        },
        "isInlineXBRL": {
          "type": "array",
          "items": { "type": "integer", "enum": [0, 1] },
          "description": "Inline XBRL flag"
        },
        "primaryDocument": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Primary document filenames"
        },
        "primaryDocDescription": {
          "type": "array",
          "items": { "type": "string" },
          "description": "Primary document descriptions"
        }
      }
    }
  }
}