API · Filings

Search filings

Find filings by company, year, document type or market.

POST/api/v1/data/filings/search

Returns a list of matching filings with docid, company_name, year, document_type and market. Use the docid with content search, or the page_ids returned from other endpoints with the snapshot endpoint.

When to use this

"Show me every annual report Neste has filed since 2020."
"Which companies released a stock-exchange release this week?"
"Is there a 10-Q for Apple FY2025 Q2?"

Body

Field	Type	Description
company	string	Company name or ticker (fuzzy match). Examples: "Neste", "NESTE", "Apple", "AAPL".
year_from	integer	Earliest fiscal year (e.g. 2020).
year_to	integer	Latest fiscal year (e.g. 2024).
document_type	string	annual_report \| interim_report \| stock_exchange_release \| 10-K \| 10-Q \| 8-K
market	string	nordic \| us. Omit to search both.
limit	integer default: 20	Max results (1–100).

Example

curl

curl https://api.clarifo.com/api/v1/data/filings/search \
  -H "Authorization: Bearer $CLARIFO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company": "Neste",
    "year_from": 2022,
    "document_type": "annual_report"
  }'

Response

json

{
  "filings": [
    {
      "docid": "neste_2024_annual",
      "company_name": "Neste Oyj",
      "year": "2024",
      "document_type": "annual_report",
      "document_type_label": "Annual Report",
      "page_count": 142,
      "market": "nordic"
    }
  ],
  "total": 1
}

Tips

Omit market to search Nordic + US in one call (concurrent backends — no latency cost).
For broad screens, leave company blank and combine document_type + year range.
Maximum limit is 100; paginate by narrowing the year range for more results.