Accounting Standards · Schema

EdgarCompanySubmission

Company entity metadata and recent filing history from the SEC EDGAR Submissions API.

Accounting StandardsFinanceGAAPIFRSXBRLFinancial ReportingSECFASB

Properties

Name Type Description
cik string Central Index Key — unique 10-digit identifier assigned by the SEC
entityType string Type of entity registered with the SEC
sic string Standard Industrial Classification code
sicDescription string Description of the SIC code industry
name string Current legal name of the entity
tickers array Stock ticker symbols for the entity
exchanges array Stock exchanges where the entity is listed
stateOfIncorporation string US state code or country of incorporation
fiscalYearEnd string Month and day of fiscal year end (MMDD)
website string Official website of the entity
filings object Recent filing history
View JSON Schema on GitHub

JSON Schema

edgar-company-submission-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/accounting-standards/refs/heads/main/json-schema/edgar-company-submission-schema.json",
  "title": "EdgarCompanySubmission",
  "description": "Company entity metadata and recent filing history from the SEC EDGAR Submissions API.",
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "description": "Central Index Key — unique 10-digit identifier assigned by the SEC",
      "example": "0000320193"
    },
    "entityType": {
      "type": "string",
      "description": "Type of entity registered with the SEC",
      "example": "operating"
    },
    "sic": {
      "type": "string",
      "description": "Standard Industrial Classification code",
      "example": "3674"
    },
    "sicDescription": {
      "type": "string",
      "description": "Description of the SIC code industry",
      "example": "Semiconductors And Related Devices"
    },
    "name": {
      "type": "string",
      "description": "Current legal name of the entity",
      "example": "Apple Inc."
    },
    "tickers": {
      "type": "array",
      "description": "Stock ticker symbols for the entity",
      "items": {
        "type": "string"
      },
      "example": ["AAPL"]
    },
    "exchanges": {
      "type": "array",
      "description": "Stock exchanges where the entity is listed",
      "items": {
        "type": "string"
      },
      "example": ["Nasdaq"]
    },
    "stateOfIncorporation": {
      "type": "string",
      "description": "US state code or country of incorporation",
      "example": "CA"
    },
    "fiscalYearEnd": {
      "type": "string",
      "description": "Month and day of fiscal year end (MMDD)",
      "example": "0928",
      "pattern": "^[0-9]{4}$"
    },
    "website": {
      "type": "string",
      "format": "uri",
      "description": "Official website of the entity",
      "example": "https://www.apple.com"
    },
    "filings": {
      "type": "object",
      "description": "Recent filing history",
      "properties": {
        "recent": {
          "type": "object",
          "description": "Most recent filings metadata arrays",
          "properties": {
            "accessionNumber": {
              "type": "array",
              "items": {"type": "string"},
              "example": ["0000320193-25-000001"]
            },
            "filingDate": {
              "type": "array",
              "items": {"type": "string", "format": "date"},
              "example": ["2025-02-01"]
            },
            "form": {
              "type": "array",
              "items": {"type": "string"},
              "example": ["10-K"]
            },
            "primaryDocument": {
              "type": "array",
              "items": {"type": "string"},
              "example": ["aapl-20240928.htm"]
            }
          }
        }
      }
    }
  },
  "required": ["cik", "name"]
}