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

accessionNumberstring required

SEC accession number (e.g., 0000320193-24-000126)

accessionNoDashesstring nullable required

Accession number without dashes (18-digit format)

cikinteger required

SEC Central Index Key (CIK) - unique company/filer identifier

formTypestring required

SEC form type (10-K, 10-Q, 8-K, 4, etc.)

filedAtstring date-time required

SEC filing date. A calendar date encoded as midnight UTC: read only the date part (YYYY-MM-DD) and never convert it to a local time zone. For the moment the SEC accepted the filing, use acceptTs.

acceptTsstring date-time nullable required

When the SEC accepted the filing (null if provisional)

provisionalboolean required

Whether this is a provisional (not yet finalized) filing

feedDaystring nullable required

Feed day in YYYY-MM-DD format

titlestring required

Filing title/description from SEC

urlstring uri required

URL to the filing index on SEC EDGAR

sizeBytesinteger required

Size of the primary document in bytes

secRelativeDirstring nullable required

Relative path on SEC EDGAR for constructing document URLs

companyNamestring nullable required

Company name from the filing

primaryTickerstring nullable required

Primary stock ticker symbol

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.