Filing statistics

GET/api/filings/stats

Returns aggregate filing activity statistics for a company, including total counts by form type, amendment rate, and XBRL coverage. Useful for understanding a company's SEC filing history and compliance patterns.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/filings/stats?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Filing statistics

Response schema

totalFilings integer
Total number of SEC filings for this company
byType map of string to object
Breakdown by form type
- * (additional properties) object
  - count integer
    Number of filings of this type
  - latest string | null
    Date of most recent filing of this type (YYYY-MM-DD)
amendments object
- count integer
  Number of amended filings
- rate number
  Amendment rate (amendments / total filings)
xbrlCoverage number
Fraction of filings with XBRL data

Example response

{
  "totalFilings": 342,
  "byType": {
    "10-K": {
      "count": 12,
      "latest": "2024-11-01"
    },
    "8-K": {
      "count": 89,
      "latest": "2024-12-15"
    },
    "10-Q": {
      "count": 35,
      "latest": "2024-08-02"
    }
  },
  "amendments": {
    "count": 8,
    "rate": 0.023
  },
  "xbrlCoverage": 0.87
}

400 Bad Request

Invalid parameters or company not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}