Filing Search

Filing list

GET/api/v2/filings

Coverage: US, the last 5 years · JP / CN, financial reports for the last 3 years
Billing: 20 cr / thousand calls

Returns a company's filings, one row per filing, with the form type, filing date and a link to the official document. Ordered by filing_date descending, then accession_number descending for the same day. Covers the last 5 years for US and the last 3 years of financial reports for JP / CN; there are no date or form-type parameters and no market-wide scan — every filing for that company inside the window comes back together. Filter for annual or quarterly reports yourself on the form_type field of the returned rows.

Row identity = ticker + accession_number. When one filing involves several companies (such as SC 13D / 13G), the endpoint returns one row under each related ticker.
There is no date parameter, so filings arriving while the caller pages through the result can make adjacent pages repeat or drop rows; in strict scenarios, de-duplicate by ticker + accession_number.
To tell whether a filing is an amendment, check the /A / 訂正 / 更正 suffix on form_type; company names come from /company-profile; body-text search goes through /filing-search.

Query parameters

Parameter	Type	Required	Description
ticker	string	required	Up to 10 tickers, comma-separated.
limit	int	optional	Maximum 500. Default: 50.
page	int	optional	Starts at 1. Default: 1.

Sort order: filing_date desc, accession_number desc. Paged with limit and page (pages start at 1); fewer rows than limit means the last page.

Response fields

Field	Type	Description
ticker	string	Canonical ticker (US has no suffix, e.g. `AAPL`; CN is `600519.SH`; JP is `7203.T`)
market	stringenum	Market code: `US` / `CN` / `JP`
form_type	string	Filing type, returned verbatim in the market's native encoding (US: SEC form names such as `10-K` / `8-K`; JP: EDINET numeric codes `120` / `140` and TDnet labels; CN: `annual_report` / `q1_report` and the like)
title	string	Filing title in the original language. CN and JP return the announcement’s own title; US is always `null` — EDGAR publishes no title, a filing being identified by its form type and date, so use `form_type` + `filing_date` there
filing_date	date	Filing date
period_of_report	date	Report period end date
accession_number	string	Native document number from the official source: US is the SEC accession (e.g. `0000320193-25-000123`), JP the EDINET docID, CN the cninfo announcement id
filing_url	string	Deep link to the official filing; opens the source document directly

Request

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/filings?ticker=AAPL&limit=20"

Response · 200

{
  "data": [
    {
      "ticker": "AAPL",
      "market": "US",
      "form_type": "4",
      "title": null,
      "filing_date": "2026-02-03",
      "period_of_report": null,
      "accession_number": "0001216519-26-000002",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000121651926000002/0001216519-26-000002.txt"
    },
    {
      "ticker": "AAPL",
      "market": "US",
      "form_type": "10-K",
      "title": "Annual report for fiscal year ended September 27, 2025",
      "filing_date": "2025-10-31",
      "period_of_report": "2025-09-27",
      "accession_number": "0000320193-25-000079",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt"
    }
  ]
}

No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.

Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.