Filings

Live and historical filing endpoints. All endpoints live under https://api.edgar.tools/v1.

GET /v1/filings/{cik}/{accession_number}#

Tier: Free

Get detailed information for a specific filing.

Parameter	Type	Description
`cik`	string (path)	Company CIK number
`accession_number`	string (path)	Filing accession number (dashed format)

curl "https://api.edgar.tools/v1/filings/0000320193/0001628280-24-123456" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "cik": "0000320193",
  "accession_number": "0001628280-24-123456",
  "form": "10-K",
  "company": "Apple Inc.",
  "filing_date": "2024-03-15",
  "acceptance_datetime": "2024-03-15T16:30:00Z",
  "primary_doc_url": "https://www.sec.gov/...",
  "filing_url": "https://www.sec.gov/..."
}

GET /v1/filings/find#

Tier: Free

Resolve a SEC EDGAR URL or accession number to a filing detail. Useful when you have an arbitrary EDGAR link and need to look up the underlying filing programmatically.

Parameter	Type	Description
`q`	string (required)	A SEC EDGAR URL or accession number (dashed or compact format)

curl "https://api.edgar.tools/v1/filings/find?q=0001628280-24-123456" \
  -H "Authorization: Bearer etk_your_key_here"

The response is the same shape as /v1/filings/{cik}/{accession_number}.

GET /v1/live/filings#

Tier: Professional

Get live SEC filings from the 48-hour real-time cache.

Parameter	Type	Description
`offset`	integer (default 0)	Pagination offset
`limit`	integer (default 100, max 500)	Page size
`form`	string	Filter by form type (e.g. `10-K`, `8-K`, `4`)
`cik`	integer	Filter by company CIK number
`since`	string (ISO timestamp)	Return only filings after this time (polling mode)

Polling pattern#

Use the since parameter with the latest_timestamp from your previous response to poll for new filings without re-fetching ones you have already seen.

# Initial fetch
curl "https://api.edgar.tools/v1/live/filings?form=8-K&limit=50" \
  -H "Authorization: Bearer etk_your_key_here"

# Poll for new filings using latest_timestamp from the previous response
curl "https://api.edgar.tools/v1/live/filings?since=2024-12-10T15:30:00Z" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "filings": [
    {
      "cik": "0000320193",
      "accession_number": "0001628280-24-123456",
      "form": "8-K",
      "accepted": "2024-12-10T15:30:00Z",
      "company": "Apple Inc.",
      "ticker": "AAPL",
      "filing_date": "2024-12-10",
      "items": ["2.02", "9.01"],
      "is_amendment": false
    }
  ],
  "offset": 0,
  "limit": 100,
  "has_more": false,
  "total": 1,
  "latest_timestamp": "2024-12-10T15:30:00Z"
}

GET /v1/live/stats#

Tier: Professional

Get statistics about the live filings cache.

curl "https://api.edgar.tools/v1/live/stats" \
  -H "Authorization: Bearer etk_your_key_here"

{
  "status": "healthy",
  "cache": {
    "total_filings": 4250,
    "window_hours": 48
  },
  "timestamp": "2024-12-10T15:30:00Z"
}

Retired: GET /v1/filings#

The unified /v1/filings timeline was retired at the Railway cutover. Requests to it return 410 Gone with a pointer to its replacement:

{
  "error": "gone",
  "replacement": "/v1/companies/:cik/filings"
}

For a company's full filing history, use /v1/companies/{cik}/filings — see Search & Browse. For the recent 48-hour window, use `/v1/live/filings` above.