Filings
Get filing details
Retrieve detailed information about a specific SEC filing by accession number.
Accession Number Format
The SEC accession number uniquely identifies each filing. It can be provided with or without dashes:
- With dashes: 0000320193-24-000126
- Without dashes: 000032019324000126
Format breakdown: NNNNNNNNNN-YY-NNNNNN
- First 10 digits: Filer's CIK (padded with zeros)
- Next 2 digits: Year
- Last 6 digits: Sequence number
Response Contents
Filing Metadata
- formType: SEC form type (10-K, 8-K, 4, etc.)
- filedAt: SEC filing date, a calendar date at midnight UTC (read the date part only; do not convert it to a local time zone)
- acceptTs: SEC acceptance timestamp (null if provisional)
- url: Direct link to filing on SEC EDGAR
Documents Array
Each filing contains one or more documents:
- Primary document: The main filing (10-K.htm, form4.xml, etc.)
- Exhibits: Supporting documents (EX-21, EX-31, EX-99, etc.)
- Use secRelativeDir + filename to construct full document URLs
Roles Array
Entities involved in the filing:
- filer: The entity submitting the filing
- issuer: The company whose securities are discussed
- reporting-owner: The insider (for Forms 3/4/5)
Constructing Document URLs
To get a specific document, combine:
https://www.sec.gov/Archives/{secRelativeDir}/{filename}
Example:
https://www.sec.gov/Archives/edgar/data/320193/000119312524123456/aapl-20240928.htm
get/api/v1/filings/{accession}
Request
- Base URL: https://earningsfeed.com
- URL: https://earningsfeed.com/api/v1/filings/{accession}
- Auth: HTTP bearer
Path parameters
accessionstring required
SEC accession number
Example:0000320193-24-000126
Response
Filing details
Example response
{
"accessionNumber": "0000320193-24-000126",
"accessionNoDashes": "000119312524123456",
"cik": 320193,
"formType": "10-K",
"filedAt": "2024-10-30T00:00:00.000Z",
"acceptTs": "2024-10-30T16:05:12.000Z",
"feedDay": "2024-10-30",
"title": "Form 10-K - Annual Report",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000119312524123456/0001193125-24-123456-index.htm",
"sizeBytes": 1234567,
"secRelativeDir": "edgar/data/320193/000119312524123456",
"companyName": "Apple Inc.",
"primaryTicker": "AAPL",
"company": {
"cik": 320193,
"name": "Apple Inc.",
"stateOfIncorporation": "CA",
"stateOfIncorporationDescription": "California",
"fiscalYearEnd": "0930",
"entityType": "operating"
},
"documents": [
{
"seq": 1,
"filename": "aapl-20241030.htm",
"docType": "10-K",
"description": "ANNUAL REPORT PURSUANT TO SECTION 13 OR 15(d)",
"isPrimary": true
}
],
"roles": [
{
"cik": 320193,
"role": "filer"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.