SEC EDGAR Submissions API
Company filing history and metadata by CIK
OpenAPI Specification
openapi: 3.0.3
info:
title: SEC EDGAR Data Company Concept Submissions API
description: 'The EDGAR Data API at data.sec.gov provides RESTful access to public company financial filings, XBRL structured financial data, and company metadata without requiring authentication or API keys. The API delivers JSON-formatted responses covering company submissions (filing history), XBRL financial facts across all reporting periods, single XBRL concept values over time, and cross-company comparative frames for US-GAAP and IFRS taxonomies.
'
version: 1.0.0
contact:
name: SEC EDGAR Help
url: https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany
license:
name: Public Domain
url: https://www.sec.gov/privacy.htm
termsOfService: https://www.sec.gov/privacy.htm
servers:
- url: https://data.sec.gov
description: SEC EDGAR Data API
tags:
- name: Submissions
description: Company filing history and metadata by CIK
paths:
/submissions/CIK{cik}.json:
get:
operationId: getCompanySubmissions
summary: Get company submissions
description: 'Returns a company''s complete filing history and metadata identified by Central Index Key (CIK). The response includes company name, SIC code, state of incorporation, addresses, phone number, and a list of recent filings with accession numbers, form types, filing dates, and document metadata. For companies with more than 40 filings, additional files are referenced in the response.
'
tags:
- Submissions
parameters:
- name: cik
in: path
required: true
description: 'Central Index Key (CIK) with leading zeros to reach 10 digits. Example: 0000320193 for Apple Inc.
'
schema:
type: string
pattern: ^\d{10}$
example: 0000320193
responses:
'200':
description: Company submission data
content:
application/json:
schema:
$ref: '#/components/schemas/CompanySubmissions'
'404':
description: Company not found
'429':
description: Rate limit exceeded (10 requests per second per user agent)
components:
schemas:
FilingList:
type: object
description: Arrays of filing metadata (parallel arrays by index)
properties:
accessionNumber:
type: array
items:
type: string
description: SEC accession numbers in format XXXXXXXXXX-YY-ZZZZZZ
filingDate:
type: array
items:
type: string
format: date
description: Filing submission dates
reportDate:
type: array
items:
type: string
format: date
description: Period of report dates
acceptanceDateTime:
type: array
items:
type: string
description: EDGAR acceptance timestamps
act:
type: array
items:
type: string
description: Securities act under which filing was made
form:
type: array
items:
type: string
description: Form types (e.g., 10-K, 10-Q, 8-K)
fileNumber:
type: array
items:
type: string
description: SEC file numbers
filmNumber:
type: array
items:
type: string
description: Film numbers
items:
type: array
items:
type: string
description: Item numbers disclosed in the filing
size:
type: array
items:
type: integer
description: Filing sizes in bytes
isXBRL:
type: array
items:
type: integer
description: Whether filing contains XBRL data (0 or 1)
isInlineXBRL:
type: array
items:
type: integer
description: Whether filing uses inline XBRL (0 or 1)
primaryDocument:
type: array
items:
type: string
description: Primary document filenames
primaryDocDescription:
type: array
items:
type: string
description: Descriptions of primary documents
Address:
type: object
description: Physical address
properties:
street1:
type: string
street2:
type: string
nullable: true
city:
type: string
stateOrCountry:
type: string
zipCode:
type: string
stateOrCountryDescription:
type: string
CompanySubmissions:
type: object
description: Company filing history and metadata
properties:
cik:
type: string
description: Central Index Key
example: 0000320193
entityType:
type: string
description: Type of entity (e.g., operating, investment company)
example: operating
sic:
type: string
description: Standard Industrial Classification code
example: '3571'
sicDescription:
type: string
description: SIC code description
example: Electronic Computers
name:
type: string
description: Company name
example: Apple Inc.
tickers:
type: array
items:
type: string
description: Stock ticker symbols
example:
- AAPL
exchanges:
type: array
items:
type: string
description: Stock exchanges where the company is listed
example:
- Nasdaq
ein:
type: string
description: Employer Identification Number
lei:
type: string
nullable: true
description: Legal Entity Identifier
fiscalYearEnd:
type: string
description: Fiscal year end date in MMDD format
example: 0926
stateOfIncorporation:
type: string
description: State of incorporation code
example: CA
addresses:
type: object
description: Mailing and business addresses
properties:
mailing:
$ref: '#/components/schemas/Address'
business:
$ref: '#/components/schemas/Address'
phone:
type: string
description: Company phone number
formerNames:
type: array
description: Previous company names
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
properties:
recent:
$ref: '#/components/schemas/FilingList'
files:
type: array
description: References to additional filing files for companies with extensive history
items:
type: object
properties:
name:
type: string
filingCount:
type: integer
filingFrom:
type: string
filingTo:
type: string