Build on South Africa filings programmatically.

The FinancialReports API delivers JSE / FSCA-supervised South African filings through the same single REST surface used across all 42 covered markets — one x-api-key header, one shared rate-limit bucket, one payload schema. A South Africa-only integration is a one-parameter filter (?country=ZA) on the global filings endpoint. No separate JSE-tier API key, no parallel billing tier, no per-country infrastructure: the same endpoint returns a SENS trading statement, a Top 40 annual report, and an AltX admission document within the identical JSON envelope.

For live pipelines, the webhook subscription is the recommended path: subscribe once, receive a POST with full filing metadata within roughly 60 seconds of SENS publication. South African market hours (09:00–17:00 SAST, UTC+2) concentrate SENS volume in the morning session and post-close window; the webhook delivery profile mirrors that pattern. The payload shape is identical across markets, so a JSE trading statement and a UK profit warning arrive at your endpoint with the same JSON structure — the country and filing_type fields are the only routing signals needed. Because many JSE mega-caps are also LSE-listed, a single corporate event may appear under both ?country=ZA and ?country=GB; cross-listing relationships are exposed in the JSON payload for deduplication downstream.

Filing bodies are available as JSON metadata, Markdown via /api/filings/{id}/markdown/ (the processed text rendered on the public web pages, normalised from the original SENS or PDF source), and original PDF for audit and archival use. The English-only character of JSE filings means the Markdown layer flows directly into NLP pipelines and LLM context windows without a translation step — a significant advantage relative to multilingual European markets. Two JSE-specific filing_type values are worth filtering for in production integrations: trading_statement (the 20%-deviation trigger) and cautionary_announcement, both of which carry high signal-to-noise ratios for event-driven strategies.

Common API integrations for South African data include backfilling FTSE/JSE Top 40 and SWIX 40 IFRS consolidated financials for EM quant research, triggering on SENS trading statements and cautionary announcements for event-driven strategies, cross-referencing JSE filings against LSE RNS for Anglo American / BHP / Glencore dual-listed positions, monitoring RESI 10 production reports for commodity-linked strategies, tracking AltX admissions and delistings, and feeding English-language SENS announcements into sector-specialist LLM tools without a translation layer. Trial keys are available on request; the web product is free and indexed for the public web, so coverage across the JSE universe is verifiable before integration.