Skip to content

Filings API Reference

Cargo Docs

docs.rs/finance-query — Filings

The Filings domain handle fetches SEC filings for a given symbol. It is backed by EDGAR (keyless — no API key required) with an optional Polygon fallback, and is always available with no feature gate.

Getting a Handle

Create a Filings handle from a Providers instance and call .get() to fetch the filing data:

use finance_query::{Providers, edgar};

# async fn run() -> Result<(), Box<dyn std::error::Error>> {
// EDGAR is keyless but SEC requires a contact email in the User-Agent.
// Initialise it once per process (or set the EDGAR_EMAIL env var).
edgar::init("you@example.com")?;

let providers = Providers::builder().build().await?;
let filings = providers.filings("AAPL");
let result = filings.get().await?;
# Ok(()) }

EDGAR requires a contact email

EDGAR needs no API key, but SEC's fair-access policy requires a contact email in the request User-Agent. Call edgar::init("you@example.com") once before fetching, or set the EDGAR_EMAIL environment variable.

The returned ProviderFilings value contains the ticker symbol and a list of individual filing entries, each with fields like filing_type, filing_date, accession_number, and filing_url.

See Also