Developer Reference

API Documentation

Filing data, closer to the source. Look up a company, retrieve a single filing, or follow the latest published events.

Overview

Base URL: https://8k.observer

GET/api/ticker/{ticker}HTML GET/api/filing/{accession}.jsonJSON GET/api/recent/JSON

01 / Company Lookup

Ticker Page

Open a company’s filing page using its ticker symbol. This route returns a human-readable HTML page, rather than a JSON response.

GET/api/ticker/{ticker}

Example RequestHTTP

GET /api/ticker/AAPL
Accept: text/html

200 OKtext/htmlCompany filing page

For paginated data, send Accept: application/json to the same route with ?limit=25. Search and filters stay within the requested ticker. JSON responses include company metadata and a next_cursor for further filings.

02 / Single Record

Filing JSON

Retrieve the published data for one filing by its SEC accession number. Use the accession number, not the company ticker, to identify a specific filing.

GET/api/filing/{accession}.json

Example RequestHTTP

GET /api/filing/0000000000-26-000001.json
Accept: application/json

Example Response200 OK

{
  "accession": "0000000000-26-000001",
  "company_name": "Example Company",
  "tickers": ["EXAMPLE"],
  "date": "2026-10-14",
  "form_type": "8-K"
}

03 / Latest Events

Recent Filings

Retrieve the latest published event filings, newest first. Omit max to request up to 30 filings, or request a smaller set.

GET/api/recent/?max=30

Example RequestHTTP

GET /api/recent/?max=10
Accept: application/json

200 OKapplication/jsonUp to 10 Filings

The collection response structure is to be finalized. Fewer records may be returned when fewer are available.

Failed Response400 Bad Request

{
  "error": "Invalid request: recents limited to past 30 filings"
}